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REFAC 


RELATED 


This document is divided into two parts. The first part contains 
general information about the use and operation of SPF. It 
includes the following major sections: 


INTRODUCTION 
GENERAL DESCRIPTION 
SYSTEM REQUIREMENTS 


The second part contains detailed information on the operation of 
SPF. It includes the following major sections: 


INVOCATION AND TERMINATION UTILITIES COPTION 3) 
MEMBER LIST COMMANDS FOREGROUND COPTION 4) 
SPF PARMS COPTION 0) BATCH COPTION 5) 
BROWSE COPTION 1) CMS COMMAND COPTION 6) 
EDIT COPTION 2) TUTORIAL COPTION 7) 
PUBLICATIONS 
° SPFE/CMS General Information Manual, GH20-2197 ~ Provides an 


overview and functional description of SPF. 


° SPE/CMS Installation and Customization Guide, SH20-2410 - 
ARS as detailed information on how to install and custom 
ajilor SPF. 


° SPF/CMS Quick Reference Summary (Card), GX20-2347 - Provides 
a summary of SPF options and command formats. 


° SPFE/CMS Logic Manual —- Describes SPF internal logic, program 
structure, and data areas (available in December 1979). 


° SPF/CMS Program Listings (Microfiche) - Compiler and Assem- 
bler listings of SPF programs Cavailable in December 1979). 


A plastic overlay, 5X20-1976, is also available to assist in the 
use of SPF program function keys on IBM 3275 or 3277 terminals. 


SPF COMMAND FORMATS 


In this document, the following notation conventions are used to 
describe SPF command formats: 


° Command verbs and keywords, which must be typed exactly as 
shown, are represented with upper-case characters. 


° Substitutable operands are represented with lower-case char- 
acters. 


® Optional parameters are enclosed in square brackets. 
e A choice of parameters is indicated with slashes. 

e Default parameters are underscored. 

Example: CAPS CON/OFF] 


The operand is optional. Either ON or OFF may be typed. If the 
operand is omitted, ON is the default. 


Preface ivi 


(This page intentionally left blank.) 


iv SPF/CMS PROGRAM REFERENCE MANUAL 


CONTENTS 


INTRODUCTION 2. 2... 1. ee ee eee 


GENERAL DESCRIPTION a fa ce 48 5 ea 
Structured Programming Features. rae 
Display Format Sx eco St das Bee Be ROK 
SPF Libraries e Tr cietoe ee Zee oe ge ig saw Si 
Menu Parameter Specification Se igh 4G Vg 

Library and File Identification 


e e e e e * e e ° e 
e s e e e e a ° ¢ e 
e e e e e e e e ° Ly 


Passwords Pe ee ee 
Saving User Parameters % gt lg. 38 
Program Access and Function Keys ee 
Scrolling . 


Overtyping of Scroll “and. Menu pees 
Split Screen 6 ee 1S AS ca a Tan Ce ee 
Help Information oie es Wee ee oe 
Library Activity Statistics at ela HS * se 
List and Log Files a a ee ae ee 
Virtual Console Pe ee ee ee ee 


SYSTEM REQUIREMENTS Ses Gare. a ee Os te ee Se, SOE 
Programming Systems ..... xe. Se ware 


e e e o e e e e e e e t e 2 ° ° 


a e e e e 
e s s e e 


° ° 


Machine Configuration pe Ng, 2 te ater 
Terminals i Jeter Woh fe aa Sa. ser owelie See he 


INVOCATION AND TERMINATION eo ee. ee ae ee Se 
Termination Menu .....-. ae ae oe ee 


MEMBER LIST COMMANDS a ‘ 
Locating Members ‘ aa By Ter c wicxe 
Single Selection Member Lists saa 
Multiple Selection Member Lists ? 


SPF PARMS COPTION 0) a < ‘ ae 
Specify Terminal Characteristics COption. 0.1) 
Specify Console, Log, and List Defaults (Opti 
Specify SPF Program Function Keys (Option 0.3 


e 


o e 


oe 2 
° ° 
. ° 
* ° 


e ° e e 
J e e e 


o ° e e 


BROWSE COPTION 1) it ‘ 
Locating Lines he es? ok ‘ 
Identifying Columns y ‘. 
Finding Character Strings , 

Command Summary ; . 

Detailed Command Description 
Character String Translation 
Hexadecimal Display ecg te “ee Si ole 


EDIT COPTION 2) 

Summary of Edit Operations 
-Edit Commands eis leer tee ay ue 
Edit Modes and Profiles P 
Edit Termination Ge Leva. He 


e ad * 


. e ° 
a a7 e 
e e e 


° 
° * . 
. 
e 


e 
a 
ee 
° 


s 
eo ¢ @ @ @ 
e e e e e e e e 
. e * e e ° ¢ a 
e ° 
e e ¢ e e e 


° * e ° e 


e 
e e e e @ « 


Basic Line Commands ai oat . 
Identifying Columns oe : 
Inserting and Deleting Lines ‘ 

Repeating Lines Siete NES ole? eae, USS he 

Ss 


e e e e eo e e 


* e* @ @ 
eo @ ee @ @ @ @ 
« 


Moving and Copying Lines ‘ 
Rules for Entering Line Command 
General Commands ela ea ee 8 
Locating Lines 
Sequence Number Generation and Control 
Statistics Generation ee ee ee 
Automatic Source Listings 
Recovery Control a i as ge ES, gh 
General Reset a. ragrt tga te, 4 ‘ 
Submit to Job Stream a ea 
Save and Cancel . 
Finding and Changing “Character Stri 
Command Summary — 
Detailed Command Description . 
Advanced Features a a ae ae ae ee 
Mask Definition iy (Ko Sc Be RS 


e 
° 
° 
° ° 
° 
° 


° 


es e¢ @ @ @ @ ee #¢ @ e eee 
e e ° * e e e e a, € e e e 


e e e ° e e e 


e e e e 2 s e e e e 
* 
e 
* e e e e e 
° e a e e e e « e « e 
° e e e e e e s e e e 


e e ° e 
e e e a 
ee ¢ @ @ 


oeee @ @ 


e e e e e ° e e e e e e e e e 


e e e e 


on 
) 


e e e « e e e e 


e e e * ° e e e e s se e e e e e e e * e e e a e e 


e e ° e e e e e e e s e a e e e 


«e@ @¢ @¢ @ € © @ Spe ee ¢« @ @ 


s e e e e e e es . e e od e e © e 


¢ a e @ e e s e a 


e e e ° e e e e e e e e e * e e e 


e J e e eo ° a a e e e ea 


N 
ww 


e e e e e e a ¢ ¢ e ° 


e e e ° e e e e e 


e a e e « e e e 


e a e ° 


e «a e e e e e e e e e e « e ° ¢ 
e e e ° e e e e ° e ° e e 

e e e e s e e e e e e e e e e e 
se ¢ e e e e e e a e e e e e 


e e s e e e e e e e e 


ev 28 @ 
eee 
oe @¢ @ 


e e 7 e.6°¢ e e e e ° a emU6¢@ ° * e ¢ 
e e e e e e e e e 

« e e ° s e 

« e 7 @ e e e ° e e e e e « e e e e 
° e a ° a e e e s e * e e e e oJ e e 


ee ¢ @ @ @ @ @ >. ¢ @ @ @ © @© ¢€ 
e 


e e e e e 


e a 
e ° e ° e e e e e e e e e e e e e 


a e e e e e e e e e ¢e * e e a e e e e e « ° e e e 
« es 


e e e e e e 2 e e ¢ e e a e e e e e & e a a s e e 


e e e * e e e e « 


e e e e e e 


Contents 


oe @¢ @ @ @ # @ @ @ @ @ @ @ # @ @© @ @ @ @# @ @ @ @ 


NRVSwWwWVVOSQernnn ~~ 


= 
w 


vi 


Indentation Changes eo NS es eS cen 
Boundary Column Definition gn 
Excluded Lines 
Data Merging and Segmentation. 
Nulls Control he oe ee a ee oe 
Tabs Definition and Control ; 
Profile Display and Control é 
Hexadecimal Display ...... 
Text Preparation Features is 


si ° ¢ a a e e e e ° 


Character Translation : : " 

Text Entry and Edit ...... ; 

Overlaying Lines ah, Ge eae ae Tae oe 
UTILITIES COPTION 3) ee ci agen gu 4 ‘ 


Library Utility COption , 1) eels 
File Utility (Option 3.2) ..... 
Move/Copy Utility COption 3.3) avi 
Project Utility (Option 3.4) ee <e 
Reset SPF Statistics Utility (Option 
Spool Utility (Option 3.6) Os res Jesse 
Reader Utility (Option 3.7) eg 
Retrieve Utility COption 3.8) . 
Retrieve All Libraries ae ae 
Retrieve Selected Libraries . 
SCRIPT/VS Utility (Option 3.9) ‘ 


Processing Sequence WO ig Sets as see aS ‘ 
Draft Document Options od the a ae 
Final Document Options eS ote -aee 


SCRIPT/VS Print Options oe ee 


FOREGROUND PROCESSING COPTION 4) a 
Assembler/Compiler Processing ox 
LOAD Processing palate “ie te ler Gene ge BS ig 


BATCH PROCESSING COPTION 5) fn i a a 
Assembler/Compiler Processing — 
LOAD Processing Gee, Ugh og ca. OA alta en a's 


CMS COMMAND COPTION 6) cee ie See 
TUTORIAL COPTION 7) 2) Ri wee ae 
APPENDIX A: SAMPLE PROBLEM ra ee 


APPENDIX B: SPF LIBRARY SPECIFICATION 
Guidelines for Library Specification 
Naming Conventions a sigs ae ol “goa 
Library Organization oe, ser Mek tes 
Record Format and Length ar ee 
Library Location §..... ar 
Link Access Mode 66 eer She, see 3 
Unique Identifier ee Sar et was ee ee 22 
Processing Considerations eases 
Foreground/Batch Processing <8 
SPF Library Statistics ae eae 


APPENDIX C: SPF LISTING FORMATS... 
APPENDIX D: SUMMARY OF SPF COMMANDS 


Member List Commands aS ee Sh Wie 

Browse Commands eo td aay se fen we” Sele ‘ 
Edit Line Commands .....+4.-. 
Edit Primary Commands Ste yee Secs 

APPENDIX E: SPF COMMAND SYNTAX ~ QUICK REFERENCE 

Member List Commands ee ae a oe coe ee 
Browse Commands ..... es ir Ge a oe 
Edit Line Commands dt nat, ee, Se 


Edit Primary Commands 
Find/Change Strings (Browse ‘and Edit? 


e e e es e es e e e ¢ e e 
e 

e e e * 7 e e ¢ e ° 

e e e e e e e e cd « e e 


e e ° e e ° e 


3.5) 


oo e8« ee e© # @ 


oo © © #® *# 


° . e ° e ° 
e ° . ° ° ” 


° * . ° » . 


AND USAGE 


. e ° ° 


- © © e# # @ 


° ° - ° 


APPENDIX F: SPF/TSO ~ SPF/CMS DIFFERENCES vs 


INDEX eo Se ee ee ee 


SPF/CMS PROGRAM REFERENCE MANUAL 


e e * ° e ° 


e e e e ¢ e e cd e cd ¢ e 
oe © © @ © @ @ @ @ © @ 
ete oo @ @ e e eo @# ¢@ e 
eee#@¢¢# e« @# e# e # # @ 

e e e e ° e « e 
« ° ° e e ¢ e + Sd e e cd 


* e ° e 


e e e e e 
e 
e e e e e « od e cf 
a e e s e e e ° e 
« e e ° a e e e ¢ 


° °. ° ° 


¢ 


e e 
° e e « e e e e ? e e e e e e e 


>. ef e© = 8 © 


° 
e 
¢ 
e 
° 
e 


e e e e e e @ e e e e 
e.¢ ° e e e € e e « e 
° e e . e e « ° e e e 


> € e© e# # @ 


e e e e a e a ¢ e ¢ e 


LIST OF ILLUSTRATIONS 


Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 
Figure 


oo @ @ 


— 
SOON AOHDWNDN 


63. 
64. 
65. 
66. 
67. 
68. 
69. 
70. 
Ye 


Primary option menu ne Git a oS 
Browse - file menu 

Browse —- member selection list 
Browse -~ data display i ig ce Dag 
SPF library organization pater & 
Hierarchy of SPF libraries . 
Default program key arrangement 


Split screen example Oe oe ze 
Primary option menu ee Sgt % 

SPF termination menu > tans Tet ee 8 
Member list display a6 «Be AL URS 26 
SPF parameter menu ‘ 


Terminal characteristics menu, 


Console, log, and list Cet menu 


Program function key menu 

Browse - file menu et a % 
Browse ~ data display 

Browse - column identification li 


Browse ~ hexadecimal display, vertical 


Edit - file menu ; a: A 
Edit - member selection list ; 
Edit - data display Sot weak 
Edit - creating new data 

List of edit commands ee at oak al ae 
Edit - caution message 


ne 


° 
. 
° 


° 
° 
°. 
e 
« eo 


e e e s e e 


° 


e 


. 


° 


°. 


° 


° 


Edit - column identification line’ 
Edit - insert and delete lines example 
Edit - repeat line example . ; " 
Edit - copy lines example a: eat fo 
Edit ~- recovery menu a. 48 
Edit - CHANGE ALL command example. 
Edit - define mask example Me ee 
Edit - left shift data example 

Edit - default column boundary settings 
Edit - boundary definition line é 
Edit - excluded lines example ae 
Edit - show lines example ws. eo Se eS 
Edit - COPY command example : bi Me we 
Edit ~ REPLACE command example a: Ne. 
Edit - tab definition line ore Ye ; 
Edit - profile display ‘ ‘ é 
Edit - hexadecimal display, data 

Edit - text split example ee. en 
Edit - move sentence example os Saude 
Edit - text flow example a a 
Edit - overlay line example ao Age Git 
Utility selection menu eg Bg te, ces Ge 


Library utility menu 


Library utility ~- ern? rename, and 


File utility menu ‘ 


File utility - specify new "SPF library : 


File utility - rename SPF library 
File utility - display informatio 


- Move/Copy utility menus . . 
- Move/Copy utility - copy members from list 


SPF project utility menu 

SPF project utility - sample listi 
Reset utility menu ef tte 
Spool utility - first menu, 6 oe 
Spool utility - second menu x8 
Reader utility menu ae es ; 
Retrieve utility menu a 
Retrieve utility - secondary menu 
SCRIPT/VS selection menu 2 
SCRIPT/VS draft document options 


SCRIPT/VS final document options 
SCRIPT/VS print menu it a ee Cee 
Foreground selection menu ;: 
Foreground - Assembler example 

Foreground - LOAD menu es wee sn US 
Batch selection menu o ies Wee dy 2e 


List of 


° 


n 


ing 


s . 
menu 
menu 


° 


e e ° e e 


e e e e e a eo e * e e e ° e e e e e 


. 


° 


e « e e ¢ « e 


e . e e e e 


oe @¢ © @ @ @ © @© @ @ @ © # @ 


eee #¢ ¢ ee ee e@ & #© @ 


delete 


* 


o 


° e e e e 


* @ ¢ @ @ 


e e e e e e e ¢ e e ° 


e ° e e e e e e e e e e e oJ e 


eee¢ee¢eee @ e © ¢ # @ 


ee @ @ #@ @ @ @ 


e ¢ 


e e ¢ e a ¢ ° « e ° e ¢e e e « e e 


e ° ° e e e ea e e e * e e a 


Illustrations 


e e e e e 7 e e 


e e e e e e e « a e e e e e e e e ¢ 


vili 


Figura 72. Batch ~ PL/I optimizing compiler example 


Figure 73. Batch ~ LOAD menu Ss iss adie 
Figure 74. CMS command menu ar 
Figure 75. Tutorial - first 2 pages 

Figure 76. Sample problem scenario (part 
Figure 77. Sample problem scenario (part 
Figure 78. Sample problem scenario sEers 
Figure 79. Sample source listing ‘ 

Figure 80. Sample index listing - source 
Figure 81. Sample log listing gtr as 


SPF/CMS PROGRAM REFERENCE MANUAL 


‘1 of 3) 
2 of 3) 
3 of 3) 


e 


‘library 


e e ° . . « 


e ° € e e @e e e ° 


ee @ @ © @ @ @ @ 


e e e cd e a 


¢ @¢ @ @ 


e e e a e e e eo ¢e 2 


e e * ¢ * e e e ° e 
. . 


INTRODUCTION 


The Structured Programming Facility (SPF) is a program develop- 
ment tool designed to take advantage of the characteristics of IBM 
3270 display terminals, and to increase productivity in an inter- 
active environment for users of both structured and conventional 
programming techniques. SPF can be used either by an individual 
programmer, or by many programmers working together on a project. 
SPF features which increase programmer productivity and simplify 
operation include: 


° Display presentations and menus which prompt the user, reduce 
keystrokes, and reduce the opportunity for error. 


° Support for multi-level programming libraries, automatic col~- 
lection of library activity statistics, and printing of 
library contents. 


° Full screen, context editing which allows additions and 
changes to multiple lines ina single interaction. 


° Simple one-character edit commands for inserting, deleting, 
duplicating, or rearranging lines of source data. 


° Forward, backward, and sideways scrolling of source data or 
listings, plus the ability to locate information by character 
string or Line number. 


° Split screen, allowing two SPF functions to be performed 
independently on the same display terminal. 


° Use of program function keys for frequently performed SPF 
operations and commands. 


® Menu-driven utilities for specification, maintenance and cur- 
rent status display of libraries and files. 


° Menu interface to standard language processors (compilers and 
assembler) for execution in the foreground or CMS batch 


machine. 

° Document preparation support, including text editing features 
and a menu interface to the SCRIPT/VS Document Composition 
Facility. 

e Hardcopy log summarizing significant user actions during the 
session. 

® Online tutorial for instruction and reference -- especially 


valuable for the occasional or novice user of SPF. 


The Structured Programming Facility/Conversational Monitor System 
CSPF/CMS) operates as a CMS application and is invoked simply by 
entering the command "SPF". It operates under VM/370 CMS Release 
5 Cand subsequent releases unless otherwise specified) with 
either the System Extensions or Basic System Extensions program 
product. It supports 24-line, 32-line, and 43-line IBM 3270 dis- 
aoe stations, equipped with either 12 or 2¢ program function 
eys. 


This manual provides detailed information on how to use SPF/CMS. 


INTRODUCTION 1 


GENERAL DESCRIPTION 


STRUCTURED PROGRAMMING FEATURES 


DISPLAY 


Structured programming emphasizes the use of segmentation and 
indentation. A source program normally consists of a large number 
of relatively small segments. The segments are stored as separate 
members of a programming library. Within a segment, source state- 
ments are block-indented under each "IF-THEN-ELSE”™ or “"DO-WHILE™ 
to show the control structure. Features of SPF which are speci f~ 
ically oriented toward structured programming include: 


° Programming library support. The SPF library structure 
facilitates the maintenance and tracking of multiple program 
segments at varying version/modi fication levels. 


° Ease of segmentation changes. One segment can easily be split 
into multiple segments, or multiple segments can be merged 
into one. 


° Ease of indentation changes. Single statements or blocks of 
statements can easily be shifted left or right by a specified 
number of column positions. 


e Insert in context. A "DO-END" pair, for example, may be coded 
on consecutive lines, and then space can be opened between the 
two lines to allow insertion of a block of code. 


e Visual verification aids. A block of code may be temporarily 
excluded from display so that the space which it occupies on 
the screen is closed up. This facilitates visual verifica- 
tion of the control structure, particularly when the length 
of a segmant exceeds the screen size. 


FORMAT 


SPF uses four basic types of display presentations. 


1. Option Selection Menus - The user selects from a list of 
options by keying a one-character selection code and pressing 
the ENTER key. Example: The SPF primary option menu 
(Figure 1). This is the first display that the user sees after 
invoking SPF. 


2. Parameter Entry Menus - The user supplies parameters by fill- 
ing in labeled fields. In many cases, SPF pre-enters parame- 
ter values based on what the user last entered. Example: The 
browse file menu (Figure 2). This menu is displayed if the 
user selects option 1 from the primary option menu. 


3. Member Selection Lists ~ Displays a list of members in a pro- 
gramming library. The user may select a member by entering a 
one-character code in front of the appropriate member name. 
Figure 3 shows an example of the member list on which the user 
has selected member COINS. 


The member selection’ list also shows the statistics for each 
mamber of an SPF library (see section entitled "Library 
Activity Statistics"™). 


4. Data Display - for displaying source data or listings. 
Figure 4 shows an example of the browse display. 


All SPF menus are formatted to fit on a 24-line screen. Displays 
which contain scrollable information, including member selection 
lists and data displays (browse and edit), occupy the full length 
of the screen (24%, 32, or 43 lines). 
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SPF/CMS PRIMARY OPTION MENU  -9--~ nner nner nn renee vai 

SELECT OPTION ===> 
USERID STEPHENS 

SPF PARMS - SPECIFY TERMINAL AND SPF PARAMETERS TIME 12:47 
BROWSE ~ DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL - 3277 
EDIT CREATE OR CHANGE SOURCE DATA PF KEYS 12 
UTILITY PERFORM SPF UTILITY FUNCTIONS | 
FOREGROUND ~- COMPILE, ASSEMBLE, LOAD, OR TEST 
BATCH COMPILE, ASSEMBLE, OR LOAD 
CMS ENTER CMS COMMAND OR EXEC 
TUTORIAL DISPLAY INFORMATION ABOUT SPF 
EXIT TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


XNA N&O 


PRESS END KEY TO TERMINATE SPF 





Figure 1. Primary option menu 


BROWSE - FILE MENU 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT = 
LIBRARY 
TYPE 
MEMBER 


SPFDEMO 
MYLIB 


vVvVvVNV Vv 


ao fF 
ut au 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
FILE ID 
MEMBER (FOR MACLIB OR TXTLIB) 
» SPECIFY: 
DEVICE ADDR. ===> LINK ACCESS MODE ===> 





Figure 2. Browse - file menu 
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4 


SPF formats the first three lines of the display as follows: 


line 2 Prompt/Input Scroll 


line 3 Long Message 





The title area (line 1) identifies the function being performed 


and, where appropriate, the library or file identification, mem- 
ber name, version number and modification level. The short mes~- 
sage area (line 1) is used to indicate: 


° ieee line number (browse) and column positions (browse and 
eat ? 


° Successful completion of a processing function, 


« Error conditions Caccompanied by audible alarm, if 
installed). 


The prompt/input area Cline 2) is used to enter an option 
selection or command. In cases where no option selection or com- 
mand is applicable, this area contains a prompt. The scroll area 
Cline 2) contains the current scroll amount whenever scrolling is 
applicable. The scroll amount may be overtyped by the user (see 
"Scrolling™). 


The long message area (line 3) is used to display an explanation 
of error conditions upon request (sea "Help Information™), 
Normally this line is blank on menus, contains column headings on 
member selection Lists, and is treated as part of the data area on 
data displays. 
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BROWSE ~- SPFDEMO.MYLIB.PLI 


COMMAND INPUT ===> 


NAME 
ACCOUNT 
ACCT 
ACCT2 

S COINS 
COMPX 
COMPY 
DCLS 


LISTNEN 
MAIN 
TESTDIR 
UPDATE 


VER.MOD CREATED 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 


79701709 
79/01/09 
79/01/09 
79704724 
79701709 
79701714 
79/04/23 
79704723 
79/01/09 
79704/23 
79701709 


LAST MODIFIED SIZE 


79701709 
79704723 
79701709 
79/04/24 
79/01/09 
79/01/14 
79704723 
79704723 
79/01/09 
79/05/06 
79701709 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


SCROL 


-_ 
ecococecorofsooeoith 


==> PAGE 


MOSTON 
KLEIN 

MOSTON 
MOSTON 
MOSTON 


XX END 33 





Figure 3. Browse - member selection list 


BROWSE - SPFDEMO.MYLIB.PLIC(COINS) - 01.04 ----- sheceateataataded LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
DEIEIE IEHEIEIEIE NEE IEIE IE IEE IIE HIER IERIE IENIE TOP OF DATA x30 8 30 EIEN -CAPS ON-%% 
COINS: 00010001 
PROCEDURE OPTIONS (MAIN})3 00020000 
DECLARE 00030000 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 
HALVES FIXED BINARY (31), 00050000 
QUARTERS FIXED BINARY (31), 00060003 
DIMES FIXED BINARY (31), 60070000 
NICKELS FIXED BINARY (31), 00080004 
SYSPRINT FILE STREAM OUTPUT PRINT3 06090000 
DO HALVES = 100 TO 0 BY -50;3 00100000 
DO QUARTERS = (100 - HALVES) TO 0 BY -253 00110000 
00120000 
06130000 


DO DIMES = ((100 - HALVES ~ QUARTERS)/10)¥10 TO 0 BY -103 
NICKELS = 100 - HALVES - QUARTERS ~- DIMES; 
PUT FILE(SYSPRINT) DATACCOUNT ,HALVES , QUARTERS » DIMES »NICKELS) 500140000 


COUNT = COUNT + 13 
END ; 
END} 


00150000 
00160000 
00170000 
END; 00180000 

END COINS; 00190001 
JES BEBE BBBBEHBBBBBREE BOTTOM OF DATA 36969696369969-9696969696963636363896-CAPS ON-%% 





Figure 4. Browse - data display 
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SPF LIBRARIES 
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An SPF library is a collection of code or data units, called mem- 
bers. Each library generally contains members with the same type 
of information. Figure 5 shows a sample set of five SPF libraries 
which contain Assembler source, COBOL source, TEXT Cobject) 
modules, test data, and SCRIPT documentation. 


SPF libraries are identified by project name, library name, and 
type, where: 


e "project name" is the common identifier for all libraries 
belonging to the same project. 


® “library name" identifies the particular set of libraries, 
such as MASTER, TEST, or ALICE. 


° "type" jdentifies the type of information in the library, 
such as ASSEMBLE, COBOL, TEXT Cobject modules), DATA, or 
SCRIPT. Except for TEXT, the SPF type qualifier need not con- 
form to the standard CMS naming conventions. 


Most projects will require a hierarchy of related libraries to 
maintain effective version control over the programming develop~ 
ment process and to reduce contention in library usage. Figure 6 
shows a sample three-level hierarchy for a project, consisting of 
a set of master libraries, a set of test libraries, and three sets 
of development (private) libraries identified by user id. 


New members or members undergoing changes will generally reside 
in the development libraries. A test library may be used to accu- 
mulate members which have been unit tested and are ready for inte- 
gration test. A master library contains fully tested members, 
which may correspond to a previously released version of the sys~ 
tem. Typically, a higher degree of control is maintained over the 
higher level libraries than the development libraries. 


SPF allows concatenation of up to four SPF libraries during source 
editing, compilation, assembly, or SCRIPT/VS processing (plus 
additional MACLIBs for compilations and assemblies). Generally, 
the lowest level library is concatenated ahead of the next higher 
level library, and so on, in bottom-to-top order. For the hierar- 
chy shown in Figure 6, a typical concatenation sequence might be 
library LARRY, followed by TEST, followed by MASTER. The concat~ 
enation applies to libraries of the same type, and is restricted 
to libraries which belong to the same project. 


The purpose of concatenation during editing is to provide down- 
ward copying of a member from a test or master library to a devel- 
opment library. The edited member is saved in the development 
library (the first library in the concatenation sequence), while 
the unchanged version remains in the test or master library. When 
the new version is fully tested, it may be promoted back to a 
higher level library by means of the SPF move/copy utility. 


The purpose of concatentation during language processing is to 
facilitate inclusion of source segments via INCLUDE or COPY 
statements Cor SCRIPT "imbed" controls), and to allow debugging 
of new or modified programs without altering the contents of the 
test or master libraries. The output from the compilation or 
assembly Cobject module) is stored in the lowest level TEXT 
library (the first library in the concatenation sequence). 


SPF libraries are maintained internally as CMS files. Each SPF 
library may consist of a set of CMS sequential files, or it may be 
a MACLIB or TXTLIB (for TEXT libraries only). The particular 
organization is designated when the library is specified to SPF 
via the file utility Coption 3.2). 


For more information on SPF libraries, see Appendix B. 
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Figure 5. SPF library organization 
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Figure 6. Hierarchy of SPF libraries 
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MENU PARAMETER SPECIFICATION 


Several parameter entry menus require specification of an SPF 
library or CMS file identifier, and (when applicable) a read 
nla update password. These are described in the following par- 
agraphs. 


Library and File Identification 


To specify a member of an SPF library, the user must enter a 
project name, library name, type qualifier, and member name. Each 
of these may contain up to eight alphameric characters, of which 
the first character must be alphabetic. SPF automatically issues 
LINK and ACCESS commands, when required, to access the minitdisk on 
which the SPF library resides. 


SPF menus prompt the user for each component of the library iden~ 
tification as follows: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


==> 
=s> 
==> 
==> 


(BLANK FOR MEMBER SELECTION LIST) 





If the member name is not specified, a member selection list will 
be displayed. 


When the library identification is displayed on a title line or 
message, SPF uses the following shorthand notation: 


project.library.type(member) 
That is, the project name, library name, and type qualifier are 
separated with periods, and the member name is enclosed in paren- 
theses. 


Some menus allow a concatenated sequence of up to four SPF 
libraries. For example: 


SPF LIBRARY 
PROJECT 
LIBRARY 


TYPE 
MEMBER 





In this example, three COBOL libraries belonging to project SAM- 
PLE would be concatenated in the following order of search: 


SAMPLE.LARRY. COBOL 
SAMPLE.TEST.COBOL 
SAMPLE.MASTER.COBOL 


SPF menus also allow users to specify other CMS files as follows: 


CMS FILE: 


MEMBER (FOR MACLIB OR TXTLIB) 


DEVICE ADDR. ===> LINK ACCESS MODE ===> 





The CMS file id is entered according to normal CMS conventions, 
i.e.: filename, filetype, and Coptionally) filemode, separated by 
one or more blanks. 
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If both an SPF library and a CMS file are specified on the same 
menu, the CMS file is used. In other words, to specify an SPF 
library, the CMS file id field on the menu must be blank. 


If the CMS file is on a minidisk which jis not currently linked and 
accessed, SPF will issue the appropriate LINK and ACCESS com- 
mands, based on user-specified LINK command parameters Cowner's 
user id, virtual device number, and link access mode). 


If a filemode is specified as part of the CMS file id, SPF will 
use the specified filemode letter in issuing the ACCESS command. 
Otherwise, SPF will use the first available (currently unused) 
filemode letter in issuing the ACCESS... Minidisks which are linked 
and accessed by SPF for the user will remain linked and accessed 
a long as they are being used by a given function Ce.g., 
edit). 


Passwords 


SPF provides a menu interface with the standard VM mechanism for 
ee DASD read-only or read/write password protection as fol~ 
ows: 





Non-display menu fields are used for both passwords. 


If the minidisk containing the SPF library or CMS file is password 
protected, the user must enter one or both passwords. Only the 
read password need be supplied for read-only functions (Ce.g., 
browse). The update password must be supplied for functions which 
cause data to be written to the minidisk (e.g., edit). In edit, 
if concatenated SPF libraries are specified which reside on two or 
more minidisks, the first library is linked for update and the 
higher level libraries are linked read-only. Therefore both a 
read and update password may be required. 


Note: The "update" password may require either the write (CW) 
password or the multiple write (MW) password depending upon how 
the SPF library was specified (see utility 3.2) or, for a CMS 
ie depending on what was specified on the menu for link access 
mode. 


Saving User Parameters 


SPF retains default parameters and pre-enters appropriate infor-~ 
mation on menus according to what was last entered by the user. 
This includes the following types of information: 


Project name, library name(s), type, and password. 

Job statement information Cfor CMS batch submission). 
Defaults for console, log, and list processing. 
Terminal characteristics and PF key definitions. 

Edit profiles, including mask, tabs, and bounds. 
Processing options for each of the language processors. 
File specification/information parameters. 


@#eeeees? 


This information is automatically maintained in an SPF-controlled 
file (referred to as the user's SPFPARMS file) so that user infor- 
mation and defaults can be carried from one session to another. 
Accordingly, a new SPF user will have to enter each type of infor- 
mation the first time it appears on a menu. But from that point 
on, he simply verifies the information and makes whatever changes 
are desired before proceeding. 
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PROGRAM ACCESS AND FUNCTION KEYS 


The program access (PA2), and 12 or 24 program function (PF) keys 
are used to request commonly used SPF operations. Keys which are 
not needed for SPF-defined key operations may be equated to edit 
and browse primary commands, or edit line commands, using the SPF 
parms option Coption 0.3). 


The default key arrangement for the 3-by-4 key pad Cright-hand 
side of the keyboard) is shown in Figure 7. These are PF keys 
1-12 on an IBM 3277 or 3275 terminal, or keys 13-24 on an IBM 3278 
or 3276 terminal. <A plastic overlay for the key pad, IBM order 
number §X20-1976, is available to assist with program key usage on 
3277 or 3275 terminals. 


For 24~-key terminals, PF keys 1-12 have the same defaults as keys 
13-24. It is strongly recommended that users of 24-key terminals 
continue to use the key pad (13-24) for SPF-defined operations, 
and redefine PF keys 1-12 to edit and browse commands. 


PF1 / 13 PF2 / 14 PF3 / 15 
HELP SPLIT END 
PFG 716 | PFE / 17 PF6 7 18 
PRINT FIND CHANGE 
PF7 / 19 PF8 / 20 PFO / 21 

A 
SWAP 
v 
(UP) 
PF1O / 22 PFLL / 23 PFl2 / 26 
CURSOR 


The two PA keys are defined as follows. These may not be rede- 
fined by the user. 


ATTENTION (PA1) Causes an immediate return to CP mode. This key 
should not be used, since it bypasses normal SPF 
termination. If it is pressed by mistake, a 
BEGIN command should be entered to resume SPF. 


RESHOW CPA2) Redisplays the contents of the screen. May be 

useful if the ERASE or CLEAR key was pressed 
accidently, or if unwanted information has been 
keyed but ENTER Cor a PF key) has not yet been 
pressed. Note that SPF does not support use of 
the Field Mark character (same key as PA2). 





PAL PA2 









ATTENTION RESHOW 












——~ ——> 





(LEFT) (RIGHT) 


Figure 7. Default program key arrangement 
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~ 
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The SPF-defined PF key operations are described below. See 
Figure 7 for the default key assignments. 


HELP Displays additional information about an error message 
or tutorial information about SPF commands and options. 


SPLIT Causes split screen mode to be entered, or changes the 
location of the split (see "Split Screen™). 


END Terminates the current operation and returns to the 
previous menu. If the primary option menu is displayed, 
this key terminates SPF. 


PRINT Causes a "snapshot" of the screen image to be recorded 
in the SPF list file. 


FIND Repeats the action of the previous FIND command or the 
FIND part of the most recent CHANGE command Capplies to 
browse and edit only). 


CHANGE Repeats the action of the previous CHANGE command 
Capplies to edit only). 


UP Causes a scroll up (see "Scrolling™). 
DOWN Causes a scroll down (see "Scrolling"™). 
SWAP Moves the cursor to wherever it was previously 


positioned on the other logical screen (sea "Split 
Screen"). 


LEFT Causes a scroll left (see "Scrolling™). 


RIGHT Causes a scroll right (see "Scrolling™). 


CURSOR Moves the cursor to the first input field on line 2 


Cnormally, the option selection or command = input 
field). Pressing this PF key again causes the cursor to 
be moved to the second input field on line 2 Cnormally 
the scroll amount field). 


RETURN Causes an immediate return to the primary option menu, 
bypassing any intermediate menus. (Logically equiv- 
alent to repeated use of the End key.) May also be used 
to go directly from one SPF option to another, without 
displaying the primary option menu, as follows: In any 
menu input field or primary command line, type an equal 
sign (=) followed by a primary option. Then press the 
Return PF key rather than the ENTER key. 


PRINT-HI Same as PRINT except that high intensity characters on 
the screen are printed with overstrikes Cusing 
suppress-space carriage control) to simulate the dual 
intensity display. 


NOP Causes the PF key to be functionless. 


The RETURN, PRINT-HI, and NOP functions have no default key 
assignments. Users of 12-key terminals may wish to assign RETURN 
to an infrequently used PF key, such as PF4é Cin lieu of PRINT) or 
PF12 Cin lieu of CURSOR). 


Caution on use of 3270 RESET key: On a 3277 or 3275, when the key~ 
board is locked during SPF processing, do not press RESET and 
attempt to enter additional information or use a PF key. Such 
action may produce unpredictable results. 
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SCROLLING 


12 


During edit and browse, the information to be displayed will gen- 
erally exceed the screen size. Scrolling allows the screen "win- 
don” to be moved up, down, left, or right across the information. 
A member list can also be scrolled up and down, if it exceeds a 
single screen length. 


Four program function (PF) keys are used for scrolling ~~ one for 
each direction. Whenever scrolling is allowed, a scroll amount is 
displayed at the top of the screen (line 2). This amount deter- 
mines the number of lines Cor columns) scrolled with each use of a 
Scroll PF key. The user may change the scroll amount by moving 
the cursor to the scroll field and overtyping the displayed 
amount. Valid scroll amounts are: 


e A&A number from 1 to 9999 - specifies the number of lines Cup or 
down) or columns Cleft or right) to be scrolled. 


° PAGE ~ specifies scrolling by one page. 
° HALF ~- specifies scrolling by a half page. 


° MAX ~- specifies scrolling to the top, bottom, left margin, or 
right margin, depending upon which Scroll PF key is used. 


e CSR - specifies scrolling based on the current position of the 
cursor. The line or column indicated by the cursor is moved 
to the top, bottom, left margin, or right margin of the 
screen, depending upon which Scroll PF key is used. If the 
cursor is not in the body of the data, or if it is already 
positioned at the top, bottom, left margin, or right margin, a 
full page scroll will occur. 


In edit, left and right scrolling is also affected by the current 
setting of the bounds. See description of BOUNDS command. 


For scrolling purposes, a "page" is defined as the amount of 
information currently being viewed. On a 24-line display termi- 
nal, this is normally 22 lines by 80 columns for browse, or 22 
lines by 72 columns for edit. CIn split screen mode, the number of 
lines will be less than 22.) Thus, in full screen browse ona 
24-line terminal, a scroll amount of HALF will move the window up 
or down by lI lines, or right or left by 40 columns. 


For member lists and browsing, the scroll amount is initialized to 


PAGE. For editing, the scroll amount is initialized to HALF. When 
the user overtypes the amount, the new value remains in effect 
until it is again changed by the user, or until a new member list 
or new data is displayed. The value MAX is an exception; follow- 
ing a MAX scroll, the scroll amount reverts to its previous value. 


Any valid scroll amount can also be entered in the command input 
field and used in conjunction with a Scroll PF key. For example: 





If a Scroll PF key ts pressed, the value in the command area will 
be used, overriding the normal scroll amount, without causing a 
change to the scroll field. This results in a one-time override; 
the value in the command area is blanked out after scrolling 
occurs. 


If some key other than a Scroll PF key is pressed, the value in 
the command area will be interpreted as a command and will proba~ 
bly result in an error message. 
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OVERTYPING OF SCROLL AND MENU PARAMETERS 


To reduce keystrokes, the scroll amount field can be changed by 
overtyping the first character(s) only: 


e To change the scroll amount to PAGE, HALF, MAX, or CSR only 
the first character need be overtyped with "P", "H"™, "M", or. 
"CY" respectively. 


° In the scroll amount field, any alphabetic characters follow- 
ing ne, number are ignored. For example "3AGE" is interpreted 
as 


The same rule applies to menu parameters in cases where the first 
letter uniquely defines the option. Examples: 





To change these options to YES or MOD, only the first character 
need be overtyped with "Y" or "M" respectively. 


SPLIT SCREEN 


During edit and browse, the entire display screen is normally used 
for displaying data from one file. Sometimes it is helpful to 
view and/or edit two different (though probably related) SPF 
library members or files, or to be able to perform a utility fune- 
tion without leaving another SPF option. Split screen mode per~- 
mits this dual use of the IBM 3270 terminal by splitting the 
screen into two "logical™ SPF screens. The top and bottom screens 
ere used independently to perform any of the functions provided by 


The two logical screens are treated by SPF as though they were 
independent terminals. Functions that can be performed simul~- 
taneously on two separate terminals can be done on the top and 
bottom screens. Functions that are in conflict on two separate 
terminals Cediting the same member of an SPF library or the same 
CMS sequential file, or browsing the same CMS file) will also be 
in conflict when simultaneously attempted on the top and bottom 
screens. 


Split screen mode is entered by pressing the Split PF key, but 
first the user moves the cursor to the desired location for the 
split. The line containing the cursor will become the split line 
and will be identified by a row of periods. When the Split PF key 
is pressed, all lines below the cursor are treated as the bottom 
screen. The first display to appear on the bottom screen is the 
primary option menu. See Figure 8. 


The split location may be repositioned at any time by moving the 
cursor to the desired line and pressing the Split PF key again. 
Repositioning may be required to bring an entire menu or tutorial 
page into view, since menus and tutorial pages are 
non-scrollable. 


When SPF is being operated in split screen mode, one or the other 
of the logical screens is considered active at any point in time. 
Any interrupts, such as the operation of program function keys, 
are interpreted as having meaning for the active screen. The 
location of the cursor is used to identify which of the two 
screens is active. To switch from the top screen to the bottom 
screen, for example, move the cursor to the bottom screen. The 
ee key may be used to move the cursor from one screen to 
another. 
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BROWSE - SPFDEMO.MYLIB.PLIC(COINS) - 01.04 LINE 00000 COLS 001 080 
COMMAND INPUT ===> SCROLL ===> PAGE 
HEE ESET EIEN IE IEE IEE IEE IEE EE IEE IERIE FOP OF DATA 2M IR-CAPS ON~ 2% 
COINS: 00010001 
PROCEDURE OPTIONS (MAIN); 00020000 
DECLARE 00030000 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 
HALVES FIXED BINARY (31), 00050000 
QUARTERS FIXED BINARY (31), 00060003 


° 4 * ° e ° 


SPF/CMS PRIMARY OPTION MENU 


SELECT OPTION ===> 

USERID 
SPECIFY TERMINAL AND SPF PARAMETERS TIME 
DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL 
CREATE OR CHANGE SOURCE DATA PF KEYS 
PERFORM SPF UTILITY FUNCTIONS 
COMPILE, ASSEMBLE, LOAD, OR TEST 
COMPILE, ASSEMBLE, OR LOAD 
ENTER CMS COMMAND OR EXEC 
DISPLAY INFORMATION ABOUT SPF 
TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


STEPHENS 
12:47 
3277 

12 


SPF PARMS 
BROWSE 
EDIT 
UTILITY 
FOREGROUND 
BATCH 

CMS 
TUTORIAL 
EXIT 


et ef@efradf¢ 


PRESS END KEY TO TERMINATE SPF 





“Figure 8. Split screen example 


Note: Since only one logical screen is active at a time, the user 
cannot split the screen while executing a foreground compilation 
or a CMS command or EXEC under SPF. 


In addition to moving the cursor to the other logical screen, the 
Swap PF key will automatically reposition the split if either log- 
ical screen is less than five lines long. For example, if the 
split occurs at the third line down from the top and the cursor is 
on the bottom screen, pressing the Swap PF key will move the cur- 
sor to the top screen and reposition the split to the third line 
up from the bottom. 


Split screen mode is terminated by ending SPF processing on either 
logical screen Ci.e., by pressing the End PF key when the primary 
option menu is displayed). The remaining logical screen is then 
expanded to its full size. Split screen may also be terminated by 
typing =X Cexit option) in the command input area and pressing the 
Return PF key. 


HELP INFORMATION 


The “help” function allows the user to obtain additional informa~ 
tion about any error message that has been displayed in the upper 
right-hand corner of the screen, or general information about an 
SPF command or option. If an error message is displayed, pressing 
the Help PF key causes a one-line explanation to be displayed. If 
this explanation is not sufficient, pressing the PF key again will 
display the appropriate section of the SPF tutorial for further 
information. If an error message was not displayed, the Help PF 
key causes the tutorial mode to be entered and displays the appro- 
priate section of the tutorial. Once in tutorial mode, pressing 
the End PF key causes a return to the screen that was being viewed 
when the Help key was originally pressed. 
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LIBRARY ACTIVITY STATISTICS 


Under user option, the SPF editor will automatically generate and 
maintain the following activity statistics for each member of an 
SPF library. 


Version Number: Initialized to 1 when the member is created. 


Modification Level: Number of times this version has’ been 
modified. 


Creation Date: When this version was created. 
Date/Time Modified: When this version was last modified. 
Current No. Lines: Current size (number of records). 
Initial No. Lines: Initial size of this version. 


No. Modified Lines: Number of lines added or changed since this 
version was created. (Zero for unnumbered 
data.) 


User Id: Who created or last updated this version 
Cnot the user id of the minidisk on which 
the library resides). 


This information is maintained in a separate file (filetype 
SPFSTATS) on the same minidisk as the SPF library. The version 
number and/or user id may be changed via the "reset SPF statis~- 
tics” utility Coption 3.5). 


For display and printing purposes, the following formats are 
used. 


° For version number and modification level: VV.MM Ce.g.» 
"LEVEL 02.15" means version 2, modification 15). 


e For creation date and date last modified: YY/MM/DD (Ce.g., 
"79/07/30" means July 30, 1979). 


° For time last modified: HH:MM Ce.g., "17:20" means 5:20 PM). 


During browse and edit, the current version and modification lev- 
el is displayed in the title area Cline 1) following the Library 
and member name. 


The statistics are displayed next to each member name on member 
selection lists. The following abbreviations are used for column 
headings: 


LIB - library number (see below) 

VER.MOD ~- version number and modification level 
CREATED - creation date 

LAST MODIFIED - date and time last modified 

SIZE ~ current number of lines 

INIT - initial number of lines 

MOD - number modified lines 

ID - user id 


The LIB column is displayed only if a concatenated sequence of SPF 
libraries was specified. It indicates the library (1, 2, 3, or 4) 
in which the member was found. For an example, see the description 
of Edit Coption 2). 


The statistics may be printed by requesting an "index listing” via 


the library utility Coption 3.1). See Appendix C for a description 
of the index listing format. 
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LIST AND LOG FILES 


VIRTUAL 


Under user option, a listing of any source module that is created 
or modified by the SPF editor may be automatically recorded in an 
SPF listing file. Source listings and other types of printed out- 
put may also be obtained from the SPF utilities. A screen "Snap- 
shot” may be obtained by pressing the Print PF key. 


SPF also maintains a log of significant user activities, includ- 
ing a record of files and SPF library members which were modified 
via edit or utility options, batch jobs which were submitted, etc. 
See Appendix C for a discussion of SPF listing and log formats. 


The SPF list and log files are generated automatically, and reside 
on the user's A-~disk during the SPF session. Their CMS file ids 
are: 


SPFLIST LISTING 
SPFLOG LISTING 


These files may be printed upon termination of SPF. A user option 
is available to prevent generation of the SPF log file (see SPF 
parms, option 0.2). Generation of the SPF list file may be 
avoided by simply not requesting any SPF print functions. 


CONSOLE 


During SPF operation, all CMS commands and EXECs issued by SPF are 
spooled to the user's virtual console, including commands 
requested by the user Cunder options 4 and 6) and commands which 
are automatically executed on behalf of the user (such as LINK and 
ACCESS commands). 


Upon termination of SPF, the user may specify if the virtual con- 
sole is to be deleted or kept. If the user specifies that the 
console is to be deleted, SPF will purge the console and set it to 
"stop" status. If the user specifies that the console is to be 
kept, SPF will leave the console in "start" status. If the con- 
sole remains in "start" status, it will be closed Creleased for 
printing) by CMS when the user logs off. 
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SYSTEM REQUIREMENTS 


PROGRAMMING SYSTEMS 


MACHINE 


SPF operates as a CMS command under VM/370 CMS Release 5 (and sub~- 
sequent releases unless otherwise specified). SPF is written in 
PL/S*® and translated into Assembler Language. It uses the VM Com- 
munication Facility for inter-machine communication and uses the 
full-screen display support of either of the following program 
products, one of which must be installed: 


" VM/System Extensions program product (SEPP) 5748-XE1 
VM/Basic System Extensions program product (BSEPP) 5748-XX8 


* Programming Language/Systems (PL/S) is an IBM proprietary lan- 
guage. 


SPF provides menu interfaces with the following IBM processing 


programs for foreground and batch execution: 


VM/370 Assembler 


COBOL Compiler and Library 5740-CB1 
COBOL Interactive Debug (foreground only) 5734-CB4 
FORTRAN IV G1 Compiler 5734-FO02 
FORTRAN Interactive Debug (foreground only) 5734-F05 
PL/I Checkout Compiler 5734~-PL2 
PL7I Optimizing Compiler 5734-PL1 


The appropriate processing programs must be installed to use the 
SPF foreground and batch processing functions. 


SPF also provides a menu interface to SCRIPT/VS to allow format- 
ting, display, and printing of text maintained in SPF libraries or 
CMS files. Use of this feature requires installation of the fol- 
lowing IBM program product: 


Document Composition Facility CSCRIPT/VS) 5748-XX9 
with the Foreground Environment Feature 


All the program-numbered items above can be ordered separately 
under IBM program product licensing agreements. 


CONFIGURATION 


The computer system requirements are the same as needed for 
VM/370; that is, an IBM System/370 Model 135 and up with at least 
384K of real storage, or an IBM 4300 series processor. 


The storage requirements for the user's VM machine will vary 
depending upon the size of the files being edited or browsed, and 
the extent that "split-screen" is used. The minimum virtual 
machine size is 512K, but a larger size (at least one megabyte) is 
recommended. SPF will display warning messages if the amount of 
available virtual storage drops below 50K bytes. If all available 
aaa ay consumed an ABEND will occur, and the user must then 
re~ : 
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. TERMINALS 


SPF supports the following IBM 3270 Display Stations: 


3275 Model 2 

3276 Models 2, 3, and 4% 

3277 Model 2 Clocal or remote attachment) 

3278 Models 2, 3, and 4 Clocal or remote attachment) 


The following keyboards are supported: 
For 3275 or 3277 Display Stations: 


78 Key Operator Console (feature 4632) 

78 Key EBCDIC Typewriter (feature 4633) 

78 Key EBCDIC Typewriter/APL (feature 4638), when operated 
with APL switch off. 


For 3276 or 3278 Display Stations: 


75 Key EBCDIC Typewriter (faature 4621) 
87 Key EBCDIC Typewriter (feature 4627) 


87 Key EBCDIC Typewriter/APL (feature 4626), when operated 
with APL switch off. 


87 Key EBCDIC Typewriter/Text (feature 4629), when operated 
with TEXT switch off. 


The standard character set (94 graphics plus blank and null) is 
supported on 3276 and 3278 Display Stations. 


The following are supported, but not required: 


Audible alarm (Feature #1090) 
Print dual~case character set (RPQ #8K0366) 


Installation of the audible alarm feature is strongly recommended 


to enhance usability. The alarm is sounded by SPF whenever a 
Warning or error message is displayed. 
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INVOCATION AND TERMINATION 


SPF is invoked by entering the command "SPF™. No parameters are 
required. When SPF receives control jit clears the screen, per- 
forms initialization functions, and displays the primary option 
menu (Figure 9). The user selects an option by typing a 
one-character code in the option field and pressing the ENTER key, 
e.g. 


SELECT OPTION ===> 2 


to select the edit option. 


SELECT OPTION ===> _ 

USERIO 
SPECIFY TERMINAL AND SPF PARAMETERS TIME 
DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL 
CREATE OR CHANGE SOURCE DATA PF KEYS 
PERFORM SPF UTILITY FUNCTIONS 
COMPILE, ASSEMBLE, LOAD, OR TEST 
COMPILE, ASSEMBLE, OR LOAD 
ENTER CMS COMMAND OR EXEC 
DISPLAY INFORMATION ABOUT SPF 
TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


STEPHENS 
12347 
3277 

12 


SPF PARMS 
BROWSE 
EDIT 
UTILITY 
FOREGROUND 
BATCH 

CMS 
TUTORIAL 
EXIT 


0 
I 
2 
3 
4 
5 
6 
7 
x 


PRESS END KEY TO TERMINATE SPF 





Figure 9. Primary option menu 


The SPF primary options are: 


° SPF PARMS - To specify SPF parameters and defaults, includ- 
ing: terminal type, number of PF keys, defaults for process~ 
ing console, log, and list files, and PF key definitions. 


° BROWSE - To display source data or output listings. Browse is 
intended primarily for viewing large files such as compiler 
listings or dumps. 


e EDIT - To create or change source data, including program 
code, test data, documentation, etc. Unlike browse, edit 
reads the selected member or entire sequential file into vir- 
tual storage and retains it there during edit operations. 


e UTILITIES - To print, rename, or delete SPF library members or 
CMS files, to specify SPF libraries, move or copy data between 
files, display or print SPF project listings, reset SPF 
library statistics, initiate spool output, retrieve data from 
the virtual reader, retrieve SPF libraries (via tape) from a 
TSO system, or format SCRIPT/VS documentation. 
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® FOREGROUND - To execute IBM language processing programs in 
the foreground, including: Assembler, COBOL, FORTRAN, PL/I 
(checkout or optimizer), and COBOL or FORTRAN interactive 
debug. Also included is a menu interface to the LOAD command. 


° BATCH ~ To generate and submit job statements and command 
streams for batch execution of IBM language processing pro- 
grams, including: Assembler, COBOL, FORTRAN, and PL/I (check~- 
out or optimizer); or for batch LOAD. 


° CMS - To enter any CMS or. CP command, or EXEC, during exe~ 
cution of SPF. 


° TUTORIAL - To obtain immediate online instruction in the use 
of SPF. The tutorial may be viewed sequentially from begin- 
ning to end, or randomly by selecting topics from the table of 
contents or alphabetized index. The tutorial may also be 
entered from other SPF options by means of the Help PF key. 


These options are described in the remainder of this manual. 


To terminate SPF, the user must be out of split screen mode and 
must return to the primary option menu (via the End or Return PF 
key}. Two termination options are available: 


1. Option "X" may be entered on the primary option menu. This 
causes SPF to terminate with user defaults for processing 
console, log, and list files, as specified via SPF parms 
Coption 0.2). 


Note: Option "X" may be used in conjunction with the Return PF 
key to immediately terminate split screen mode, or Cin single 
screen mode) to immediately terminate SPF, as follows: In any 
menu input field or primary command line, type an equal sign 
(=) followed by an X. Then press the Return PF key. 


2. The End PF key may be pressed to display the SPF termination 
menu (Figure 10) for specification of console, log, and list 
processing. 


Upon termination of SPF, the screen is cleared, and the user is 
returned to normal CMS processing. 


TERMINATION MENU 
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The termination menu allows the user to specify whether the vir~ 
tual console is to be deleted (purged) or kept. If the user spec” 
ifies that the console is to be deleted, SPF will purge the 
console and set it to "stop" status. If the user specifies that 
ba is to be kept, SPF will leave the console in "start" 
status. 


The termination menu also allows the user to specify whether the 
log and list files are to be printed, deleted (purged), or kept 
without printing. If the files are to be printed, the following 
spool parameters may be speci fied: 

e Number of copies ~- if more than one copy is desired. 


° Spool class ~ for other than class A. 


@ For user - to spool the output to another user's virtual 


printer on the same VM system Cignored if either "to 
user/machine” or "remote node id” is specified). 


° 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in the VM/370 CP 
Command Reference, GC20-1820. 
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° To user/machine ~- to spool the output to the virtual reader of 
another user or machine. 


° Remote node id - if the desination is a remote node on the 
network (valid with either "to user/machine”™ or "tag 
keywords", but not both). 


e Tag keywords ~ to specify control parameters for printing ona 
remote non-VM system. See description of TAG command in 
either the VM/370 Networking manual, S$H20-19377, or the VM/370 
RSCS Networking manual, SH24-5005. 


Once the options have been entered on the termination menu, tha 
ENTER key is pressed to complete SPF termination. Alternatively, 
the End PF key may be pressed to redisplay the primary option menu 
and continue SPF processing. (Use of the End PF key» in this 
instance, provides an escape mechanism in the event that the ter- 
mination procedure was entered by mistake.) 


Notes: 


1. If the user selects option "X" but has not specified defaults 
via option 0.2, the termination menu is displayed. 


2. The termination menu shown in Figure 10 is the version which 
is displayed if both log and list files have been used. If 
only one has been used during the SPF session, a different 
version of the menu is displayed showing the process option 
for either log or list, whichever is appropriate. 


SPECIFY DISPOSITION OF CONSOLE, LOG, AND LIST FILES 
ENTER/VERIFY PARAMETERS BELOW: 


CONSOLE PROCESS OPTION (K OR D) 
LOG PROCESS OPTION (P, K, OR DJ 
LIST PROCESS OPTION (Py K, OR D) 


VALID PROCESS OPTIONS: 
P - PRINT FILE (AND DELETE) 
K - KEEP FILE - 00 NOT PRINT 
D - DELETE (PURGE) FILE - DO NOT PRINT 


LOG/LIST SPOOL OPTIONS: 
NUMBER OF COPIES SPOOL CLASS ===> A ‘FOR’ USER ===> 
3800 KEYNORDS 


FOR SPOOLING LOG/LIS ANOTHER PERSON OR MACHINE: 
"TO" USER/MACHINE 
REMOTE NODE ID 
TAG KEYRORDS 


PRESS ENTER TO COMPLETE SPF TERMINATION 
PRESS END KEY TO RETURN TO PRIMARY OPTION MENU 





Figure 10. SPF termination menu 
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MEMBER LIST COMMANDS 


For any of the following SPF options, a member selection list will 
be displayed if an SPF library or a CMS MACLIB or TXTLIB is speci- 
fied but no member name is supplied: 


Browse 

Edit 

Library Utility 

Move/Copy Utility 

Reset SPF Statistics Utility 
SCRIPT/VS Utility 


An example of a member list display is shown in Figure ll. 


BROWSE ~ SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> 


ice SCROLL ===> PAGE 
NAME VER.MOD CREATED 


LAST MODIFIED MOD 


ACCOUNT 
AaccTl 
AcCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.902 
01.00 


79/01/09 
79/01/09 
79/01/09 
79/04/724 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79704723 
79/01/09 


79/01/09 
79/04/23 
79/01/09 
79/04/24 
79/01/09 
79/01714 
79/04/23 
79704723 
79/01709 
79705706 
79/01/09 


17:07 
14:52 
17:07 
16:29 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


-— 
eoocororodce 


MOSTON 
KLEIN 

MOSTON 
MOSTON 
MOSTON 


XX END %% 





Figure 11. Member list display 


LOCATING MEMBERS 


The member list may be scrolled up, and down by means of the Scroll 
PF keys. In addition, a LOCATE command may be entered in the com- 
mand input field on line 2 of any member list display. Format: 


LOCATE member-name 


Command abbreviations: LOC, L 





This causes a direct scroll to the specified member name Ci.e.,» 
the entry for the specified name will appear as the first line 
following the header lines). If the specified name is not found, 
scrolling is to the member name which Cin the collating sequence) 
would immediately precede the specified name. 
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SINGLE SELECTION MEMBER LISTS 


For browse, edit, and the SCRIPT/VS utility, one member at a time 
may be selected from the list. The member may be selected in 
either of two ways: 

° Move the cursor down the left hand side of the screen and 
enter the single character "S”" in front of the desired member 
name, or 

° Enter a SELECT command in the command input field on line 2. 


The format of the SELECT command is: 


SELECT member~-name 





Command abbreviations: SEL, $ 


Use of this command allows selection of a member which is not in 
the list. For edit, selection of a non-existent member is the 
machanism for creating a new member, 


Upon termination of browse or edit (via the End PF key) the member 
list is redisplayed with an automatic scroll to the member just 
processed. The user may then select another member or press the 
End PF key again to return to the file menu. 


Note: When the member list is redisplayed following browse or 
edit, it will not include new members which may have been created 
by another user Cor, in split screen mode, on the other logical 
screen). To display an up-to-date list, return to the previous 
menu, leave the member name blank, and press ENTER. 


MULTIPLE SELECTION MEMBER LISTS 
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For the other utility options, multiple members may be selected 
from the list. A single character code may be typed in front of 
one or more member name(s) before pressing the ENTER key. For the 
move/copy and reset utilities, the selection code is "S". For the 
library utility, the allowable codes are "P™ (for print), "R" (for 
rename), "D" (for delete), and "B" (for browse). 


Select member Cexcept library utility) 


Print member (Clibrary utility only) 


Rename member (library utility only) 
Delete member (library utility only) 
Browse member Clibrary utility only) 





When ENTER is pressed, the selected member(s) are processed anda 
confirmation indicator is displayed to the right of each member 
name that was processed. See description of the utilities for 
examples. The user may then select additional members (scrolling 
to bring them in view, if necessary) or press the End PF key to 
return to the file menu. 
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SPE _PARMS: COPTION 0) 


The SPF parms option allows the user to display and change a vari-~- 
ety of SPF parameters at any time during the SPF session. Changes 
remain in effect until the user changes the parameter again. Fur- 
thermore, these parameters are automatically retained for each 
user, so that current values remain in effect across SPF sessions. 


When the SPF parms option is selected (primary option 0) a second- 
ary selection menu is displayed (Figure 12). This menu may be 
bypassed by entering two numbers, separated by a decimal point, on 
the primary option menu. For example, entering "0.2" on the pri-~ 
mary menu has the same effect as entering "0" on the primary menu 
and "2" on the secondary menu. 


SELECT OPTION ===> _ 


1 TERMINAL - SPECIFY TERMINAL CHARACTERISTICS 
2 PRINT - SPECIFY SPF CONSOLE, LOG, AND LIST DEFAULTS 
3 PF KEYS <= SPECIFY PF KEYS FOR 3277 TERMINAL WITH 12 PF KEYS 





Figure 12. SPF parameter menu 


The following describes each of the SPF parms functions, corre- 
sponding to the three options on the secondary menu. 
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SPECIFY TERMINAL CHARACTERISTICS COPTION 0.1) 


When this option is selected (SPF parms option 1), a manu is dis- 
played (Figure 13) which allows the user to specify the terminal 
type and number of program function (PF) keys on the terminal. 


After these parameters have been reviewed or changed, the user can 
press the End PF key to return to the previous manu. 


TERMINAL CHARACTERISTICS 
ENTER/VERIFY PARAMETERS BELOW: 


TERMINAL TYPE (3277 - 327773275 DISPLAY STATION) 
(3278 - 3278/3276 DISPLAY STATION) 


NUMBER OF PF KEYS (12 ~ TWELVE PROGRAM FUNCTION KEYS) 
(24 ~ TWENTY FOUR PROGRAM FUNCTION KEYS) 





Figure 13. Terminal characteristics menu 


SPF will automatically determine the terminal type during SPF 
initialization, and set it to the appropriate value. SPF will 
automatically set Cor change) the number of PF ners in the follow- 
ing cases: 


° If the eecninel type is 3277, SPF will initialize the number 
of keys to 12. 


° If the terminal type is 3278, SPF will initialize the number 
of keys to whatever was "remembered" from the user's last SPF 
session (for a new user, the number of keys is initialized to 


° 


° If the user presses a PF key higher than 12, SPF will set the 
number of keys to 24. 


SPF cannot sense the number of PF keys if the user switches from a> 
3278 with 24 PF keys to a 3278 with 12 PF keys. In this case, the 
user must inform SPF of the number of PF keys via option 0.1. 
Otherwise, the incorrect set of "remembered" key definitions will 
be used (see option 0.3) 
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SPECIFY CONSOLE, LOG, AND LIST DEFAULTS COPTION 0.2) 


When this option is selected (SPF parms option 2), a menu is dis~ 
played which allows the user to specify default processing for the 
virtual console and for the SPF log and list files, to ba used 
when SPF is terminated via primary option "X", (Figure 14). If 
default processing options have not been specified, primary 
option "X" will cause the SPF termination menu to be displayed. 


The number of lines per page and spool parameters for printing the 
log and list files may also be specified. The initial defaults 
for new users are: 


Lines per page ===> 
Number of copies ===> 
Spool class ===> 


- Cfor both log and list) 


No other SPF-supplied initial defaults are provided for the other 
parameters on this menu. 


Normal values for lines per page ara: 


60 - for printing 6 lines per inch 
80 ~- for printing 8 lines per inch 


CONSOLE, LOG, AND LIST DEFAULTS 
ENTER/VERIFY PARAMETERS BELOW: 


CONSOLE PROCESS OPTION ===> _ (K OR D) LINES PE 
LOG PROCESS OPTION ===> (P, Ky Dy OR N) LOG 
LIST PROCESS OPTION ===> (P, K OR D) LIST 


VALID PROCESS OPTIONS: 
P - PRINT FILE (AND DELETE) 
~ KEEP FILE - DO NOT PRINT 
~ DELETE (PURGE) FILE ~ DO NOT PRINT 
~ DO NOT GENERATE LOG FILE 


LOG/LIST SPOOL OPTIONS: 
NUMBER OF COPIES ===> 1 SPOOL CLASS ===> A ‘FOR' USER 
3800 KEYWORDS s=5> 

FOR SPOOLING LOG/LIST ANOTHER PERSON OR MACHINE: 
"TO" USER/MACHINE = 
REMOTE NODE ID = 
TAG KEYWORDS = 


T 


Figure 14. Console, log, and list defaults menu 


The virtual console is automatically started the first time SPF 
invokes a CMS command (typically, a LINK or ACCESS executed auto~ 
matically on behalf of the user). Upon termination of SPF, the 
console may be kept Cin "Start" status) or deleted (purged and set 
to "stop" status). An appropriate processing option for the con- 
sole would be: 


K ~- if the user normally runs with a virtual console 
D - if the user normally runs without a virtual console. 
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SPECIFY 


The SPF log file is created the first time the user performs some 
action which results in a log message, such as saving edited data 
or submitting a job to the batch machine. The SPF list file is 
created the first time the user requests a print function. 


For the log file, a process option of N may be specified to pre- 
vent generation of the log. Generation of the list file may be 
avoided by simply not requesting any print functions. 


See section entitled "Termination Menu™ on page 20 for a 
discussion of spool parameters which may be specified for the log 
and list files. 


After the parameters on this menu have been reviewed or changed, - 
the user can press the End PF key to return to the previous menu. 


SPF PROGRAM FUNCTION KEYS COPTION 0.3) 


When this option is selected (SPF parms option 3), a menu is dis~ 
played which allows the user to specify the mapping of the PF keys 
into specific functions (CFigure 15). Before selecting this 
option, the user should ensure that the correct terminal type 
(3277 or 3278) and number of PF keys (12 or 24) has been specified 
via option 0.1. 


SPF maintains three different sets of key definitions for each 
user, as follows: 


3277 Cor 3275) with 12 PF keys 
3278 Cor 3276) with 12 PF keys 
3278 Cor 3276) with 24 PF keys 


The appropriate set of key definitions will be itnvoked based on 
the terminal type and number of keys (as specified via option 
0.1). The menu shown in the figure is for a 3278 with 24 PF keys. 


The allowable SPF-defined key functions are listed at the bottom 
of the menu. See section entitled "Program Access and Function 
Keys" for a description of these functions. More than one key can 
be assigned to the same function. A function need not be assigned 
to a key, with one exception: There must be at least one End PF 
key assigned within the first 12 keys. 


Entering a blank for any PF key definition causes the specified PF 
key to be assigned its SPF default. The default key definitions 
are discussed under "Program Access and Function Keys" and are 
also shown in Figure 15. 


The user may equate a PF key to an edit or browse primary command, 
or to an edit line command, in the following manner: 


>string Causes the specified PF key, when used in edit or browse, 
to simulate the entering of a primary command. Example: 


PF10 ===> >FIND ABC 


Pressing PF1O when browsing or editing data will have 
the same effect as entering a FIND ABC primary command. 


:string Causes the specified PF key, when used in edit, to 
simulate the entering of a line command. Example: 


PF1l ===> :1F 


Pressing PF1l when editing data will have the same 
effect as entering the "TF" (text flow) Line command on 
whichever line the cursor is positioned when the key is 
pressed. 
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PROGRAM FUNCTION KEY DEFINITION 
ENTER/VERIFY PARAMETERS BELOW FOR 3278 TERMINAL WITH 24 PF KEYS: 


PFL 
PF2 
PF3 
PF4 
PF5 
PF6 
PF7 
PF8 
PF9 
PF1O 
PFLI 


HELP_ PF13 
SPLIT PF14 
END PF15 
PRINT PF16 
FIND PF17 
CHANGE PF18 
UP PF19 
DOWN PF20 
SHAP PF21 
LEFT PF22 
RIGHT PF23 
CURSOR PF24 


LEFT 
RIGHT 
CURSOR 


HUA EHH a ana 
HU UH an a a fe. 
VVVV VMN VV VV VV 
Hun A te te 
ft Ho WU TE Ue te oe te 
VVVVVV VV VV VV 


PF12 


VALID OPTIONS: (BLANK RESETS TO DEFAULT OPTION) 
HELP SPLIT END PRINT FIND CHANGE 
UP DOWN SWAP LEFT RIGHT CURSOR 
NOP RETURN PRINT-HI 

OR EQUATE TO EDIT/BRONSE COMMAND: 
>CMD... (PRIMARY COMMAND ) EXAMPLE: PF10 >TABS ON 
:CMD... (CEDIT LINE COMMAND) EXAMPLE: PFII1 





Figure 15. Program function key menu 
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ROWS 


COPTION 1) 


The browse option allows the user to display source data and 
listings stored in SPF libraries or CMS files with the following 
charactersitics: 


° Fixed or variable record formats 
° Logical record lengths up to and including 32767 Bytes 


When browse is selected (primary option 1), a menu is displayed to 
allow the user to specify either an SPF library or CMS file id. A 
user id, virtual device address, LINK access mode, and read pass~ 
word may also be specified, if needed, for linking to another 
user's virtual disk. See Figure 16. 


For SPF libraries, MACLIBs, and TXTLIBs, the user can supply the 
name of the member to be browsed, or can leave the member name 
a pe request a member list from which a member may be 
selected. 


When the user has properly specified the data to be viewed, the 
first page of data is displayed. Two lines are reserved at the 
top of the screen for title information, short messages, command 
entry, and the scroll amount. The remainder of the screen con- 
tains the data (Figure 17). 


Note: Under browse, any invalid (non-displayable) characters in 
the data are displayed as periods. 


During browse, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll toa 
particular character string, line number, or symbolic label. 


Browse provides six commands, described in the following 
sections, which may be entered in the command input field on line 
2: 


LOCATE FIND 
cOLSs CAPS 
RESET HEX 


Browse may be terminated by pressing the End PF key, which causes 
a return to the previous menu Ceither the member selection list or 
the file menu). When return is to the member selection list, the 
member just browsed will appear at the top of the list. Another 
member may be selected from the list or the End key may be pressed 
again to return to the file menu. 


When the file menu is displayed, another file or member may be 
selected, or the End key may be pressed to return to. the primary 
option menu. 
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BROWSE ~ FILE MENU 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


udu 
vVvVVYv 


mom ut 
“uat u 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
FILE ID = 
MEMBER = 
IF NOT LINK 

D 
D 


> CBLMAIN COBOL Al_ 
> (FOR MACLIB OR TXTLIB) 
ED 


SPECIFY: 


? 
OWNER’S I => DEVICE ADDR. ===> LINK ACCESS MODE ===> 


==> 


READ PASSWOR 


Figure 16. Browse - file menu 


BROWSE - CBLMAIN COBOL Al LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
JHB BEBE BHO TOP OF DATA 2363636: IEIEHHIEKKKH-CAPS ON-1% 
600100 IDENTIFICATION DIVISION. 

000200 PROGRAM-ID. ‘F20D1000'. 

000300 DATE-COMPILED. AUG. 20, 1979 

000400 ENVIRONMENT DIVISION. 

600500 CONFIGURATION SECTION. 

000600 SOURCE-COMPUTER. IBM-370. 

000700 OBJECT-COMPUTER. IBM-370. 

000800 INPUT-OUTPUT SECTION. 

000900 FILE-CONTROL. 

001000 SELECT OLD-COMREC ASSIGN TO DA-S-DDI1. 

001100 SELECT D1-REPORTS ASSIGN TO UR-S-DILOUT. 

001200 SELECT OPTION-CARD-FILE ASSIGN TO UR-S-SYSIN. 

001300 DATA DIVISION. 

001400 FILE SECTION. 

001500 FD OLD-COMREC 

001600 LABEL RECORD IS STANDARD 

001700 RECORDING MODE IS F 

001800 BLOCK CONTAINS 0 RECORDS 

601900 DATA RECORD IS COMREC1. 

002000 COMREC]. 

002100 62 DUMMY PICTURE X(520). 

002200 D1-REPORTS 


- 002300 LABEL RECORD IS OMITTED 


002400 RECORDING MODE IS F 
002500 BLOCK CONTAINS 133 CHARACTERS 





Figure 17. Browse ~ data display 
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LOCATING LINES 


32 


During browse, the current position of the screen window is indi- 
cated by the line/column numbers in the upper right hand corner of 
the screen. The line number refers to the first data line current- 
ly being displayed (Ci.e., the first line after the two header 
lines). It indicates the relative position of that line in the 
file Cor member), and is unrelated to any sequence numbers which 
may be contained within the data. The "TOP OF DATA" message is 
treated as relative line zero. 


The LOCATE command may be used to scroll directly to a specified 
line number. It may also be used to scroll to a symbolic label, 
which must have been previously defined by the user, as follows: 
Scroll to any desired line and enter a label of the form: 

-XXXXKXXX 
Cperiod followed by up to seven alphameric characters) in the com- 
mand input line. The label is treated as an internal symbol and 
equated to the top line on the screen. Labels are not retained 
upon exit from browse. 


Format of the LOCATE command: 


LOCATE line-number/label 


Command abbreviations: LOC, L 





Either a line number or a label must be entered as an operand. 


The "lina-number"™ operand is a numeric value of up to eight digits 
Cleading zeros need not be typed), which refers to the relative 
line number as displayed in the upper right hand corner. 


The "label™ operand consists of a period €.) immediately followed 
by up to seven alphameric characters. Scrolling is performed to 
oS line which was previously equated to the label, as described 
above. 


Note: The period is mandatory when defining a label. It is 
optional when referring to a label in a LOCATE command unless the 
label begins with a numeric character, in which case the period is 
required to distinguish the label from a line number. 
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IDENTIFYING COLUMNS 


The COLS command causes a column identification line to be dis- 
played, temporarily overlaying the first data line. The RESET 
eens terminates display of the column identification line. 
ormats: 


COLS 
Command abbreviation: COL 


RESET 
Command abbreviation: RES 


Neither command uses any parameters. 













An example of the column identification line is shown in 
Figure 18. The digits on the identification line indicate the 

"tens" positions, @a.g., "1" indicates column 10, "2" indicates 

eee 20, etc. The plus signs (+) indicate the "fives" posi- 
ions. 


BROWSE - CBLMAIN COBOL Al -<-4---<or en eee e newer ~~ene= LINE 00022 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
wee poe owen pee 2 nn pen Sen pee Gen nn pan Gene pe Geter Parente nn § 

002200 FD DI-REPORTS 

002300 LABEL RECORD IS OMITTED 

002400 RECORDING MODE IS F 

002500 BLOCK CONTAINS 133 CHARACTERS 

002600 DATA RECORD IS DI-LINE. 

002700 DI-LINE. ; 

002800 02 COLUMNS PICTURE X(133). 

602900 OPTION-CARD-FILE 

003000 LABEL RECORD IS OMITTED 

003100 BLOCK CONTAINS 1 RECORDS 

003200 — RECORDING MODE IS F 

003300 BATA RECORD IS O-C. 

603400 01 O-C. 

003500 02 DUMMY PICTURE X(80). 

003600 WORKING-STORAGE SECTION. 

003700 77 OP-SUB PICTURE $99 COMPUTATIONAL VALUE 0. 
003800 PREV~DEVICE~TYPE-CODE PICTURE X VALUE 'I'. 
003900 PREV~ACTV-CODE PICTURE 9 VALUE Q. 
004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 
0604100 C-SWITCH PICTURE X VALUE '0’. 
004200 PREV~-SYSTEM-CODE PICTURE X VALUE SPACE. 
004300 GSA-REF PICTURE XX. 

004400 UNIT~-PRICE-NUMERIC PICTURE $9(8)V99. 
004500 BML-NUMERIC PICTURE $9(8)V99. 
004600 PREV-MODEL PICTURE X(5) VALUE ‘0°. 





Figure 18. Browse - column identification line 
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FINDING CHARACTER STRINGS 


The FIND command is used to find one or more occurrances of a 
specified character string. It allows special forms of character 
strings and several optional parameters to control: 


e- Starting point and direction of search 
° Special conditions to control character string "match" 
° Column limitations on extent of search 


The command summary, which follows, describes the basic form of 
FIND which is most frequently needed. The remainder of this 
section provides detailed information about the various special 
features and options. 


Command Summary 
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The basic format for FIND is: 


FIND string CALL] 





Command abbreviation: F 


The operands may be separated by blanks or commas. The ALL oper- 
and is optional, and may precede or follow the string. 


As a general rule, the strings are typed without delimiters. For 
example: 


FIND XYZ 
to find the next occurrence of XYZ. 


Strings may be delimited with either apostrophes (') or quotation 
marks (€"). Delimiters must be used if a string contains imbedded 
blanks or commas, or if a string is the same as a command keyword. 
For example: 


FIND ‘EVERY ONE’ 


Mt a the next occurrence of "EVERY ONE” (which contains a 
an 


If the ALL operand is omitted, the FIND command searches for the 
next occurrence of the string starting at the current cursor 
location. (CIf the cursor is not itn the data area of the screen, 
scanning starts at the beginning of the first line which is cur-~ 
rently being displayed.) Scrolling is performed, if necessary, to 
bring the string into view. The cursor is positioned under the 
string and a verification message is displayed in the upper 
right-hand corner of the screen. The Find PF key may be used to 
find each successive occurrence of the string. 


If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED” message is displayed 
and the audible alarm is sounded Cif installed). The Find PF key 
may then be used to wrap to the top of data and continue search- 
ing. If the string is not found anywhere in the data a "NO xxxxx 
FOUND" message is displayed. ; 


If the ALL operand is typed, the FIND command searches for all 
occurrences of string starting at the top of the data, and posi- 
tions the cursor under the first occurrence. The verification 
message indicates the number of occurrences found. 
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Nae 


iled Command Descriptio 


The 


complete format for FIND, showing all optional parameters, 


follows: 


FIND string (CNEXT/ALL/FIRST/LAST/PREV] 
CCHARS/PREFIX/SUFFIX/WORD] 
[col-1 [col-2]] 


Command abbreviation: F 





The 


Keyword abbreviations: PRE (for PREFIX), SUF (for suffix) 


operands may be separated with blanks or commas, and may be 


typed in any order except that col-2, if typed, must follow col-1. 
The string operand is required; the others are optional. 


The 


"string" operand specifies the string to be found. It may be 


specified in any one of the following forms: 


Any string of characters not starting or ending with an apos~- 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 


A delimited string: Any string starting and ending with an 
apostrophe (') but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain- 
ing imbedded quotation marks. 


A hex string: Any delimited string of valid hexadecimal char- 
Oreoeas preceded or followed with the character X. Example: 
C27B° 


A text string: Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings.” Example: T'conditions for! 


A picture string: <Any delimited string of picture charac~ 
ters, preceded or followed with the character P. See dis~- 
cussion under "Use of Picture Strings.” Example: P’*.' 


A single asterisk (%). This causes the previous value of 
"string"™ that was used in a FIND command to be used again. 
The previous value of a character string Creferenced via * or 
used by the Find PF key) is retained until the browse option 
is terminated (i.e. until return to the primary option menu). 


Starting Point and Direction of Search 


The 
cont 


NEXT 


ALL 


starting point, direction and extent of the search may be 
rolled by one of the following operands. 


Scan starts at the current cursor location and proceeds 
forwards to find the next occurrence of the string. 


Scan starts at the top of data and proceeds forwards to 
find all occurrences of the string. 


FIRST Scan starts at the top of data and proceeds forwards to 


LAST 


PREV 


find the first occurrence of the string. 


Scan starts at the bottom of data and proceeds backwards to 
find the last occurrence of the string. 


Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of the string. 


If this operand is omitted, the default is NEXT. 
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If the direction of the search is forward Ci.e, if FIRST, ALL, or 
NEXT was specified), pressing the Find PF key finds the next 
occurrence of the designated string. If the direction of the 
search is backward (i.e., if LAST or PREV was specified), pressing 
the Find PF key finds the previous occurrence of the designated 
string. The other optional parameters (CHARS, WORD, PREFIX, SUF- 
FIX, col-i, and col-2) remain in effect, as specified on the last 
FIND command. 


The search proceeds until one or all occurrences of the string are 
found, or until the end of data is encountered. If the string is 
not found, one of the following actions takes place. 


® For FIRST, LAST, or ALL - a "NO xxxxx FOUND" message is dis~ 
played in the upper right-hand corner of the screen. 


° For NEXT - a "BOTTOM OF DATA REACHED" message is displayed. 
° For PREV - a "TOP OF DATA REACHED” message is displayed. 
When "BOTTOM OF DATA REACHED" or "TOP OF DATA REACHED” is dis- 


played, the user may press the Find PF key to continue searching 


by wrapping to the top (Cor bottom) of the data. If no occurrence 
is found anywhere in the data, a "NO xxxxx FOUND" message is dis~ 
played. 


Conditions for Character String Match 


The conditions for a successful "match" with the string may be 
controlled based on whether the data string begins and/or’ ends 
with a non-alphameric character (Ci.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF), and WORD. In the following 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 


CHARS 'DO' po DO' +ADO (DONT) ADO- 
PREFIX 'DO' +ADO (DONT) ADO- 


SUFFIX 'DO' pO +ADOQ (DONT) ADO- 





WORD ‘DO' bo +ADG (DONT) ADO- 


If this operand is omitted, the default is CHARS. 


Column Limitations 
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If the "col-1" and "col-2" operands are typed (two integers 
separated by a comma or at least one blank), they indicate the 
starting and ending column positions for the search. If col-1 is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1 nor col-2 is 
specified, the search will continue across all columns. 
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Use of Text Strings 


A text string, which may be used as the string in a FIND command, 
allows the search to be satisfied without regard to upper/lower 
case alphabetics. Example: FIND T'CONDITION NO. 1' would suc- 
cessfully find any of the following: 


CONDITION NO. 1 
Condition No. 1 
condition no. 1 
coNDitION nO. 1 


An ordinary delimited string, such as: FIND ‘CONDITION NO. 1’ 
would find only the first example listed above. 


Within the text string itself, is is immaterial whether alphabet~ 
ics are typed in upper or lower case Ceven if CAPS mode is off). 
For example, all the following have the same effect: 


FIND T'Edit Commands’ 
FIND T'EDIT COMMANDS'* 
FIND Tredit commands' 


Use of Picture Strings 


A picture string, which may be used as the string in a FIND 
command, allows the search to be satisfied when a particular type 
of character is encountered. Special characters are used within 
the picture string to represent the type of character to be found, 
as follows: 


STRING MEANING 


P*’=" - any character Cdon't care) 

P'-=" - any non-blank character 

P*.,* - any non-displayable Cinvalid) character 

P'#* ~- any numeric character (0-9) 

P'-" =- any non-numeric character 

P'a" - any alphabetic character Cupper or lower case) 
P'<' - any lower case alphabetic character 

P'>" - any upper case alphabetic character 

P'S" - any special character (not alpha or numeric) 


Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters, in which case the characters 
represent themselves. 


Examples of picture strings: 


P'###" - a string of three numeric characters 

P'-> =" - any two non-blank characters surrounding a blank 
P*..% - any non-displayable character 

PY #* - a blank followed by a numeric character 

P'#AB" - a numeric character followed by 'AB' 


Examples of FIND command using picture strings: 


FIND Pt." ~ find the next non-displayable character 

FIND P'-" 72 =- find the next non-blank character in col 72 

F-Pt at ~ find the next line with a blank in col 1 
followed by a non~blank 


When the picture string P".' is used to find a non-displayable 
character, the hexadecimal representation of the character is 
shown in the confirmation message which appears in the upper 
right-hand corner of the screen. 
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CHARACTER STRING TRANSLATION 


If the character string operand of the FIND command contains 
alphabetic characters, they are automatically translated to upper 
case if browse is operating with CAPS mode on; they are left as-is 
Cnot translated) if browse is operating with CAPS mode off. 


ea mode may be turned on or off by using the CAPS command. For~- 
mat: 


CAPS [ON/OFF] | 


If the ON/OFF operand is omitted, ON is the default. Under 
browse, CAPS mode is always initialized ON. 


Note: The "TOP OF DATA" and "BOTTOM OF DATA®™ lines contain an 
indication of the current mode. 


HEXADECIMAL DISPLAY 


When browse is operating in HEX mode, three lines are displayed 
for each source line. The first line shows the data in standard 
character form. The following two lines show the same data in 
hexadecimal representation. See Figure 19. 


Note: The FIND command may also be used to find invalid characters 
or any specific hex character, regardless of the setting of HEX 
mode. See discussion of picture strings and hex strings under the 
FIND command. 


sa mode may be turned on or off by using the HEX command. For- 
mat: 


HEX [EON/OFF] [VERT/DATAI 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The VERT Cvertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically (two rows per byte) under each character, as 
shown in Figure 19. DATA causes the hexadecimal representations 
to be displayed as a string of hex characters (two per byte). 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 
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BROWSE ~ BHEX SCRIPT Cl wewerewee-= LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
HEHEHE HEH IEE EH HE HEHE IEE KEE MK HHH KRKKEKHE TOP OF DATA KKH KHMER HKKKEKE-CADS ON~2 
:H3.HEXADECIMAL DISPLAY 
7CF4CCECCCCCDCD4CCEDDCE 
A83B8571453941304927318 
WHEN BROWSE IS OPERATING IN HEX MODE, THREE LINES ARE DISPLAYED FOR EACH 
ECCDSCODEEC4CE4DDCDCECDC4CD4CCESDDCCE4ECDCC4DCDCE4CDC4CCEDDCECC4CDD4CCCcCc 
6855029662509206 7591395 7095085 704645B03895503955201 950492 731854066905138 


SOURCE LINE. THE FIRST LINE SHOWS THE DATA IN STANDARD CHARACTER FORM. 
EDEDCC4DCDC444ECC4CCOEESDCDCGECDEEGECC4CCEC4CDGEECDCCDC4CCCDCCECD4CDDD4 
26493503955B0038506 9923039550286620385041310950231541 940381 913359066948 


THE FOLLOWING TWO LINES SHON THE SAME DATA IN HEXADECIMAL 
ECC4CDDDDECDCGEED4DCDCEGECDESECC4ECDC4CCEC4CD4CCECCCCCDCD 
3850663366 95 703660395520286603850214504131095085714539413 
REPRESENTATION. SEE :FIGREF REFID="BHEX'.. 

DCDDCECDECECDD444ECC4 7CCCDCCADCCCC77CCCE 744 
95795255313965B002550A6979561956 94ED2857DBB 

:NOTE.THE FIND COMMAND MAY ALSO BE USED TO FIND INVALID CHARACTERS, 
7DDECSECC4CCOC4CODDCDC4DCESCDED4CC4EECCGED4CCDC4CDECDCC4CCCDCCECDE6 
45635B38506 95403644154041801326025042540 36069540955 139403819133592B 


REGARDLESS OF THE SETTING OF HEX MODE. SEE DISCUSSION OF PICTURE 





Figure 19. Browse ~ hexadecimal display, vertical 
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The edit option allows the user to create, display,» and modify 
source data Cprogram code,, test data, documentation, etc.) stored 
in SPF libraries or CMS files with the following characteristics: 


e Fixed or variable record formats 
« Logical record lengths up to and including 255 bytes, but not 
less than 10 bytes 


When edit is selected Cprimary option 2), a menu is displayed to 
allow the user to specify either an SPF library or CMS file id. A 
user id, virtual device address, and link access mode may also be | 
specified, if needed, for linking to another user's virtual disk. 
Sea Figure 20. 


For SPF libraries and CMS files that are MACLIBs or TXTLIBs, the 
user can supply the name of the member to be edited, or leave the 
member name blank to request a member list from which a member may 
be selected. 


If a CMS file id is specified and the file does not currently 
exist, the record format (CRECFM) and logical record length 
CLRECL) may be specified on the menu. If these fields are left 
blank, the RECFM and LRECL which the user last specified for this 
filetype will be used. If the user has never specified a RECFM 
and LRECL for this filetype, the new file will be created with 
RECFM=F (fixed) and LRECL=80. 


If the minidisk is password protected, an update password must be 
specified. For a concatenated sequence of SPF libraries which do 
not reside on the same minidisk, two passwords may be required: 
An update password for the first library in the concatenation 
sequence, and a read password for the other libraries (which must 
all be accessable via the same password). 


The menu also allows specification of a profile name, which may be 
entered to override the default edit profile. See description 
under "Edit Modes and Profiles."™ 


A concatenated sequence of SPF libraries may be specified. The 
concatenated sequence applies to fetching of members to be edit- 
ed. The libraries are searched in the designated order to find 
the member and bring it into working = storage. If a member 
selection list is requested, the list indicates the library where 
the member was found (library 1, 2, 3, or 4) -- see Figure 21. 
When the edited member is saved, it is placed (or replaced) in the 
first library in the concatenation sequence regardless of its 
original location. 


SPF libraries must have been previously specified to SPF (see 
YFile Utility", option 3.2). Selection of a non-existent CMS 
sequential file or a non-existent member of a library allows cre- 
ation of new data. 


The member or sequential file is read into virtual storage, where- 
in it is updated during the edit operations. Use of virtual stor- 
age for edit work space results in high performance, but requires 
sufficient virtual storage for the data being edited. Warning 
messages will be displayed if the amount of available virtual 
storage drops below 50K bytes. If all available storage is con- 
sumed an ABEND will occur, and the user must then re-IPL CMS. 


The edit data display is similar to a browse display except that 
each line consists of a six-column line-number field followed by a 
72-column data field (see Figure 22). The line-number field 
reflects the contents of the sequence numbers in the data, if the 
data is numbered. For unnumbered data, the line numbers start at 
1 and are incremented by 1. 
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EDIT - FILE MENU 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


SPFDEMO 
===> MASTER 


s3==> 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
FILE ID 
MEMBER 
IF NOT LINKED, SPECIFY: 
OWNER'S ID 


FOR NEW 
RECFM 
LRECL 


CMS FILE: 


DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD UPDATE PASSWORD ===> 


PROFILE NAME (BLANK DEFAULTS TO TYPE) 





Figure 20. Edit - file menu 


EDIT --~ SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> 
NAME LIB 


SCROLL ===> PAGE 


“VER.MOD CREATED LAST MODIFIED SIZE MOD 


ACCOUNT 
accTl 
ACCT2 
ACCT3 
ACCT4¢ 
ACCT5 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 


MAIN 
MINUS 
PLUS 
TESTDIR 
UPDATE 
ZCOMP 
XKXEND HH 


Re KH HM ee ee ee TS NN Oe 


I 


01.00 
01.01 
01.00 
01.02 
01.60 
01.01 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.03 
01.00 
61.02 
01.00 
01.01 


79701709 
79/01/09 
79/01/09 
79701709 
79/04/23 
79/04/23 
79/04/24 
79/01/09 
79701714 
79/04/23 
79/04/23 
797901709 
74/10/04 
79/01/09 
79/04/23 
79/01/09 
79/01/14 


79/01/09 
79/04/23 
79/01/09 
79/04/23 
79/04/23 
79/04/23 
79/04/24 
79701709 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/01/09 
79/01/09 
79/05/06 
79/01/09 
79/01/14 


17:07 
14:52 
17:07 
15:07 
15:04 
15:09 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
16:57 
17:08 
17:04 
17:08 
12:30 


-_ 
mocqonoc Se Of HPoOwoead 


HOSTETL 
HOSTETL 
HOSTETL 
ORR 

ORR 

ORR 
MOSTON 
KLEIN 
MOSTON 
JOSLIN 
JOSLIN 
MOSTON 
MOSTON 
KLEIN 





Figure 21. Edit - mamber selection list 
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SUMMARY 


EDIT ~-~ SPFDEMO.MYLIB.PLIC(COINS) - 01.04 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
JBHHOHE JOHOR OBHHOBOBEBHRE TOP OF DATA 369636363660 00050003026 962200 IEIEI EER IEEE 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN)3 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

000900 SYSPRINT FILE STREAM OUTPUT PRINT} 

001000 BDO HALVES = 100 TO 0 BY ~503 

001100 DO QUARTERS = (100 ~ HALVES) TO 0 BY ~25; 

001200 DO DIMES = ((100 ~ HALVES ~- QUARTERS)/10)*10 TO 0 BY -10; 
001300 NICKELS = 100 - HALVES - QUARTERS ~ DIMES; 

001400 PUT FILE(SYSPRINT) DATAC COUNT » HALVES » QUARTERS ,DIMES, NICKELS )3 
001500 COUNT = COUNT + 13 

001600 END; 

001700 END; 

001800 END; 

001909 END COINS; 

HEHEHE HEI HEI IE IEEE EERIE BOTTOM OF DATA 226 IESEIEIEIE IE IE IE IESE IE EIEN IEIEIEIEE 





Figure 22. Edit - data display 


Notes: 


1. Under edit, any invalid (Cnon-displayable) characters are 
replaced on the screen (Cbut not in the data) with attribute 
bytes, which display as blanks and may not be overtyped. 


2. Invalid characters may be displayed and edited by entering 
HEX mode (see description of HEX command) or by using the FIND 
and CHANGE commands. 


OF EDIT OPERATIONS 


Under edit, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll toa 
particular character string or line number. 


To modify one or more lines of data, the user simply moves the 
cursor to the desired location and enters the new information by 
overtyping the existing lines. Several lines may be modified 
before pressing the ENTER key. 


Edit Commands 


Lines may be deleted, inserted, shifted left or right (for inden- 
tation changes), duplicated, or rearranged by overtyping the 
line-number fields with "line commands” consisting of one or more 
characters. Single character line commands operate on individual 
lines €a.g., D to delete a line, I to insert a blank line, M to 
move a line). Double character line commands operate on blocks of 
lines (€e.g., DD on two different lines to indicate the first and 
last lines to be deleted). 
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In most cases, a number may follow the line command to indicate 
multiple occurrences (e.g., I3 to insert three blank lines). 
Several line commands as well as data modifications may be typed 
before pressing the ENTER key. 


Note: SPF does not distinguish between "input mode” and "edit 
mode™ during edit operations. The I Cinsert) line command is used 
to add new lines, either between existing lines or at the and of 
the data. When a new file or member is specified for editing, the 
initial display contains several inserted lines between the "TOP 
OF DATA" and "BOTTOM OF DATA” message lines (Figure 23). 


For general edit operations, "primary commands” may be entered at 
the top of the screen to: control edit modes, locate a specific 
line, submit data to the job stream of another virtual machine, 
find and change designated character strings, control sequence 
numbering and character translation, effect segmentation changes 
Csplitting a member into two members or merging two members into 
one), save the edited data, or cancel without saving. 


EDIT ~--- NEMFILE COBOL Al COLUMNS 007 078 
COMMAND INPUT ===> _ SCROLL ===> HALF 
JERE SIE IEIEIE EIEIO IEEE TOP OF DATA x66 3026020260 2026 6 EE IEIEIEIEIEIEE IEICE EIEIO IIE 
eeseen 


JBHBHEE JOBE RBBB BHEHREHEEREHHOHREE BOTTOM OF DATA 3636363636303: 2026365 30300220202 IEIEIEREIEDEDEDEDENE 





Figure 23. Edit - creating new data 


A new SPF user need not master all the line commands and primary 
commands to make effective use of edit. The command descriptions 
in this manual are grouped under the following headings: 


° Basic Line Commands - Describes the commands used for identi- 
fying columns, inserting and deleting lines, repeating lines, 
moving and copying lines, and rules for entering line com- 
mands. Should be read by all users. 


e General Commands - Describes the commands used for locating 
lines, sequence number generation and control, statistics 
generation, automatic source listings, recovery control, gen- 
eral reset, submit to job stream, save and cancel. Should be 
read by all users. 
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° Finding and Changing Character Strings - Contains a summary 
of the FIND and CHANGE commands, which should be read by all 


users, followed by a detailed description of FIND/CHANGE 
optional parameters and features. 


e Advanced Features - Describes the commands used for line mask 
definition, indentation changes, boundary column definition, 
excluded lines, segmentation changes, nulls control, tabs 
definition and control, profile display and control, and 
hexadecimal display. 


° Text Preparation Features - Describes the commands used for 


hes Bela translation, text entry and edit, and overlaying 
ines. 


A list of edit commands, and the section under which each is 
described, is shown in Figure 24. A command summary may also be 
found in Appendix D, and a quick reference summary in Appendix E. 


DOCUMENT 


SECTION EDIT LINE COMMANDS EDIT PRIMARY COMMANDS 


BASIC 
LINE 
COMMANDS 


Figure 24. 


GENERAL 
COMMANDS 


ADVANCED 
FEATURES 


TEXT 
PREPARATION 
FEATURES 


< 
> 
) 


DATA LEFT 
DATA RIGHT 
COLS LEFT 
COLS RIGHT 


TEXT ENTRY 
TEXT SPLIT 
TEXT FLOW 
OVERLAY 


List of edit commands 
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EXCLUDE 
SHON 
FIRST 
LAST 


LOCATE 
NUMBER 
RENUM 
UNNUM 
AUTONUM 
STATS 


COPY 
MOVE 
CREATE 
REPLACE 


RECOVERY 
RESET 
SUBMIT 
SAVE 
CANCEL 





Edit Modes and Profiles 


Edit is capable of operating in the following modes: 


e NUMBER Mode - controls validation and generation of sequence 
numbers. 


e AUTONUM Mode - controls automatic renumbering when the data 
1s saved. 


° STATS Mode ~- controls generation of SPF statistics for mem- 
bers of SPF libraries. 


° PRINT Mode - controls automatic recording of source Listings 
in the SPF list file. 


° CAPS Mode - controls translation of alphabetic characters to 
upper case. 


e NULLS Mode - controls replacement of trailing blanks with 
null characters on the display screen. 


® TABS Mode ~- controls use of "hardware" or "logical™ tabs fea~ 
ture. 


® a Mode - controls display of data in hexadecimal represen~- 
tation. 


° RECOVERY Mode - controls automatic recording of edit trans~- 
actions to facilitate recovery following a system failure. 


Each mode may be turned on or off independently of the other modes 
by means of the following primary commands: NUMBER, AUTONUM, 
STATS, PRINT, CAPS, NULLS, TABS, HEX, and RECOVERY. See the com- 
mand descriptions for further explanation. 


The current settings of the modes, together with the current MASK, 
TABS, and BOUNDS lines, are maintained in an edit "profile”™ which 
may be displayed at any time via the PROFILE primary command. 

When edit is terminated, the current profile is automatically 
saved in the user's SPFPARMS file. 


SPF maintains up to 25 different edit profiles for each user. 
This allows different mode settings and different MASK, TABS, and 
BOUNDS lines to be remembered and used as the initial settings for 
different types of source data. 


Each profile is normally associated with the data "type™ (the SPF 
library type or CMS filetype). When the user edits a COBOL file, 
for example, the profile which was in effect the last time he fin- 
ished editing a COBOL file is used. Additional profiles may be 
created by specifying a profile name on the edit file menu, or as 
an operand on the PROFILE command. 


Listed below are the default mode settings when a new profile is 
generated Ci.e., when the user edits a particular type of data for 
the first time, or specifies a new profile name on the edit menu). 
If the user already has 25 edit profiles, the least recently used 
profile is automatically deleted when a new profile is generated. 


NUMBER ON 
AUTONUM ON 


STATS ON 
PRINT OFF 
CAPS ON 
NULLS OFF 
TABS OFF 
HEX OFF 


RECOVERY OFF 
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Three of the mode settings will be automatically changed, if 
appropriate, whenever data is fetched for editing: 


e NUMBER mode will be set on or off depending upon whether the 
data currently contains sequence numbers. 


° CAPS mode will be set on or off depending upon whether the 
data currently contains lower case alphabetics. 


e STATS mode will be set on if the member currently has SPF 
statistics. If STATS mode is already on and the member has no 
statistics, a caution message will be displayed but STATS 
mode will be left on. CSTATS mode is ignored for CMS files.) 


A caution message is displayed whenever edit automatically 
changes one of these mode settings. The message is displayed in 
the first two lines of the data area. An example is shown in 
Figure 25. A caution message is also displayed if edit discovers 
invalid Cnon-displayable) characters in the data. 


Caution messages may be removed from display by using the RESET 
primary command or by deleting the individual message lines using 


the "D" line command. Caution messages are never saved as part of 
the data. 


EDIT ~-- SPFDEMO.MYLIB.PLICCOINS) ~ 01.04 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
HHH III OI III IEE IEEE IIE EEE EIEIO INN TOP OF DATA 3€369696 969696969696 0 IESE IEEE TE IE IE TENE IESE NE HEHE TENE TE HIE DE 
==MSG> ~-CAUTION- PROFILE CHANGED TO "NUMBER ON STD" (FROM "NUMBER OFF"). 

==MSG> DATA HAS VALID STANDARD NUMBERS. 

000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

000700 DINES FIXED BINARY (31)> 

000800 NICKELS FIXED BINARY (31), 

600900 SYSPRINT FILE STREAM OUTPUT PRINT3 

001000 DO HALVES = 100 TO 0 BY ~-503 

001100 DO QUARTERS = (100 ~ HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY ~10; 
001300 NICKELS = 100 - HALVES ~ QUARTERS ~- DIMES; 

001400 PUT FILE(SYSPRINT) DATACCOUNT ,HALVES » QUARTERS » DIMES, NICKELS )3 
061500 COUNT = COUNT + 15 

001600 END; 

001700 END; 

001800 END; 

001900 END COINS; 

HHI HIN III IE HIE ERNIE RNIN BOTTOM OF DATA 236263 362665 52K SEITE IIE IE IEIE IE EIEN IEE RENE 





Figure 25. Edit - caution message 
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Edit Termination 


Normally, edit is terminated by pressing the End PF key, which 
causes the following actions: 


l. If any changes have been made to the data: 


° The data is renumbered if both NUMBER mode and AUTONUM 
mode are on. 


° The data is automatically saved -- see description of 
SAVE command. 


Note: "Special™ lines (MASK, TABS, COLS, BOUNDS, message 
lines, and profile display lines) are never saved as part 
of the data, and need not be deleted prior to issuing a 
SAVE command or pressing the End PF key. 


° The SPF statistics are updated Cor generated if none pre- 
viously existed) if an SPF library was specified and 
STATS mode is on. 


° A source listing of the data is recorded in the SPF list 
file for eventual printing if PRINT mode is on. 


2. A return is then made to the previous menu Ceither the member 
selection list or the file menu). When return is to the mem- 
ber selection list, the member just edited will appear at the 
top of the list. 


Note: The Return PF key, which is logically equivalent to 
repeated use of the End PF key, will also cause action (1) to 
occur. 


The user may save the data without terminating edit Cand without 


printing) via the SAVE command. The user may also terminate edit~- 
ing without saving Cor printing) via the CANCEL command. 
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ee 


BASIC LINE COMMANDS 


The following commands are described in this section: 


COLS Ccolumns) M (move) 

I Cinsert) : C Ccopy) 

D (delete) A Cafter) 
R Crepeat) B Cbefore) 


These are all "lLine™ commands, entered by overtyping the 6-digit 
line number field on one or more lines. 


Identifying Columns 


A column identification line may be displayed by entering the 
characters "COOLS" or "COL" in the line command area, overtyping 
the line number. 


COLS - Display column identification line 


Command abbreviation: COL 





When the ENTER key is pressed, a special line is inserted at the 
designated position and the remaining lines are pushed down by one 
line position. An example of the COLS line is shown in Figure 26. 


EDIT --- SPFDEMO.MYLIB.PLIC( COINS) -~- 01.04 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
SHH JOR OU BOBEOEEOBHBRERE TOP OF DATA 336363696363696963 5962620903056 26 5096 HENEIERE IEE IEIEIEIEIEE 
o00100 COINS: 

000200 PROCEDURE OPTIONS (MAIN)3 

000300 DECLARE 

600400 COUNT FIXED BINARY (31) AUTOMATIC INIT (13, 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

SCOLS> ----$~--< Leo $$$ 2 oo Jann npn nnn pee eee pene po P= 
000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

600900 SYSPRINT FILE STREAM OUTPUT PRINT; 

001000 DO HALVES = 100 TO 0 BY -503 

001100 DO QUARTERS = (100 ~ HALVES) TO 0 BY ~253 

001200 DO DIMES = ((100 ~ HALVES - QUARTERS)/10)*¥10 TO 0 BY -103 
001300 NICKELS = 100 ~ HALVES - QUARTERS - DIMES; 

001400 PUT FILE(SYSPRINT) DATAC COUNT HALVES , QUARTERS »,DIMES ,NICKELS )3 
001500 COUNT = COUNT + 13 

001600 END; 

001700 END; 

001800 END 3 

001900 END COINS; 

DERI SEIEEIE EIEIO IEICE EEE BOTTOM OF DATA 1 969696969696969696969696969696 9636 963696 96 96 9696 EIEIENE 





Figure 26. Edit - column identification line 
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Insertin 


50 


Note: Unlike browse, COLS is a line command, not a primary command 
Cit may not be entered in the command input field on line 2). 


The column identification line may be removed from display by 
entering a "D" jin the line command area, or by entering a RESET 
primary command. The column identification Line is never saved as 
part of the data. 


and Deleting Lines 


To insert a line, the single character "I" is entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, a new line is inserted immediately following the line 
containing the "I". A number may follow the "I" to indicate that 
more than one line is to be inserted. For example, "I3" would 
cause three new lines to be inserted. 


I ~ Insert line 
In - Tnseart Wf Tings 





If any information is entered on an inserted line Ceven a blank 
character), the line becomes part of the source data and is 
assigned a line number the next time the ENTER key is pressed. If 
no information is entered on an inserted line, the line is auto- 
matically deleted the next time the ENTER key is” pressed. If 
information is entered on the last Cor only) inserted line and if 
the cursor is still in the data portion of that line when ENTER is 
pressed, another new line is automatically inserted following 
that line. This allows line after line of data to be generated in 
a “continuous insert™ mode. 


To delete a line, the single character "D"™ is entered in the line 
command area, overtyping the line number. A number may follow the 
"D" to indicate that more than one line is to be deleted. For 
example, "D99999" would cause all remaining lines to be deleted, 
starting with the line containing the "D99999". 


D - Delete line 


Dn - Delete "n" lines 
DD - Delete block of lines 





To delete a block of lines, the double character "DD" is entered 
in the Line command area of the first and last lines to be 
deleted. The first and last line need not be on the same page; 
a he may be used between entering the first "DD" and the sec~ 
ond " 


Figure 27 shows a before-and-after example of line insertion and 
deletion. Three new lines are inserted after line 800 and line 
1400 is deleted. 
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EDIT --- SPFDEMO.MYLIB.PLI(COINS) - 01.04 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HHH HHH WMH IIH IH HEH IE IEEE HEI HIENIHK TOP OF DATA 666 III IE IIE IEE IEE HEE IEEE IEE DE TENE SE IEE ENE 
000100 COINS: 
000200 PROCEDURE OPTIONS (MAIN)3 
000300 DECLARE 
000400 COUNT | FIXED BINARY (31) AUTOMATIC INIT (1)> 
000500 HALVES FIXED BINARY (31), 
000600 QUARTERS FIXED BINARY (31), 

DINES | FIXED BINARY (31), 

NICKELS FIXED BINARY (31), 

SYSPRINT FILE STREAM OUTPUT PRINT3 

DO HALVES = 100 TO 0 BY -50; 
DO QUARTERS = (100 - HALVES) TO 0 BY ~253 
DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY ~103 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 
D_ PUT FILE(SYSPRINT) DATA( COUNT HALVES, QUARTERS ,»DIMES NICKELS) $ 
001500 COUNT = COUNT + 13 
001600 END; 
001700 END} 
001800 END; | 
001900 END COINS; 
HHH IIE HIE KH HEME HE HEHEHE HE HEE HE FEN FE HE FE HE SE HEHE SESE BOTTOM OF DATA 2363636369696 3E ENE TE IE TE IE IE DE IEE SE IE IE 9G 96 5 HEIE TE 


EDIT --- SPFDEMO.MYLIB.PLI(COINS) - 01.04 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HHMI IIE IER HHI HIM TOP OF DATA dss 3663629626 IE INSEE IE IE DE IE HE ESE IEE IE ETE DE HE EIENE 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN)3 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 


000900 SYSPRINT FILE STREAM OUTPUT PRINT} 

001000 DO HALVES = 100 TO 0 BY -50; 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 - HALVES - QUARTERS)/10)*%10 TO 0 BY -10; 
001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001500 COUNT = COUNT + 13 

001600 END; 

001700 END; 

001800 END; 

001900 END COINS; 

JEG JERE EEE IEEE BOTTOM OF DATA  36369696969636369696969636 969696 3036 96SEC IEIEIEIEEIEIEDE 





Figure 27. Edit - insert and delete lines example 
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R ati ine 


To repeat a line, the single character "R" is entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, a duplicate copy of the line is inserted immediately fol- 
lowing the Line containing the "R". A number may follow the "R" 
to indicate that the line is to be repeated more than one time. 
For example, "R5" would cause five identical copies of the line to 
be inserted. 


Repeat line 
Repeat line "n" times 


Repeat block of lines 
Repeat block of lines "n" times 





To repeat a block of lines, the double character "RR" is entered 
in the line command area of the first and last lines to be 
repeated. The first and last lines need not be on the same page. 
A number way follow the "RR" on either the first or Last lines Cor 
both) to indicate that the block of lines is to be repeated more 
than one time. 


Suppose, for example, the following code is to be generated: 


DECLARE 
I FIXED BINARY(31), 7% WORK COUNTER X7 
J FIXED BINARYC31), 7% WORK COUNTER X/ 
K FIXED BINARY(31), 7% WORK COUNTER X/ 
L FIXED BINARYC31); “7% WORK COUNTER ¥/ 


The easiest way to generate this code is to type the first two 

lines, repeat the second line three times, then move the cursor to 

each of the repeated lines and make the necessary changes. A 

eee oo ere illustration of the repeat command is shown in 
igure . 
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EDIT --- SPFDEMO.MYLIB.PLI(DCLS) - 01.00 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HHH HHH HHH HEH HEHE HEHE EIEN HEH EE HE HEH HEHE HIE TOP OF DATA %36363696969696 969696696 IESE IEEE HEME EE IEE IEEE IEE 
000100 /% SEGMENT 'DCLS' -~- INCLUDED FROM SEGMENT 'MAIN' */ 
DECLARE 
I FIXED BINARY(31), 7* WORK COUNTER "7 
DECLARE 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 
HALVES FIXED BINARY (31), 
QUARTERS FIXED BINARY (31), 
DIMES FIXED BINARY (31)> 
NICKELS FIXED BINARY (31), 
SYSPRINT FILE STREAM OUTPUT PRINT} 
DO HALVES = 100 TO 0 BY -503 
DO QUARTERS = (100 - HALVES) TO 0 BY ~-253 
DO DINES = ((100 - HALVES ~ QUARTERS)/10)*10 TO 0 BY -103 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 
PUT FILEC(SYSPRINT) DATA(COUNT, HALVES» QUARTERS »DIMES »NICKELS )5 
COUNT = COUNT + 13 
END$ 
END}; 
END 3 
END COINS; 
HHI HI IM HICH IN HEH IHN IHRE BOTTOM OF DATA 2€€ CIEE IEIE IEEE TENE HIE IEEE EEE DE 


EDIT -~- SPFDEMO.MYLIB.PLI(DCLS) - 01.00 ~ COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HRI IIH HITE IIH NIE KIKI NIN TOP OF DATA RII IIE EH IEE IE IEE IEN HII 
000100 /% SEGMENT 'DCLS' -- INCLUDED FROM SEGMENT ‘MAIN' 

000200 DECLARE 

000300 I FIXED BINARY(31), 7% WORK COUNTER 

900310 I FIXED BINARY(31), 7* WORK COUNTER 

000320 I FIXED BINARY(31), 7* WORK COUNTER 

0003306 I FIXED BINARY(31), 7% WORK COUNTER 

000400 DECLARE 

000500 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000600 HALVES FIXED BINARY (31), 

000700 QUARTERS FIXED BINARY (31), 

000800 DIMES FIXED BINARY (31), 

000900 NICKELS FIXED BINARY (31), 

001000 SYSPRINT FILE STREAM OUTPUT PRINT3 

001100 DO HALVES = 100 TO 0 BY -503 

001200 DO QUARTERS = (100 - HALVES) TO 0 BY ~25; 

001300 DO DIMES = (€100 ~ HALVES - QUARTERS)/10)*10 TO O BY -10; 
001400 — NICKELS = 100 - HALVES ~- QUARTERS ~ DIMES; 

001500 PUT FILE(SYSPRINT) DATACCOUNT HALVES» QUARTERS ,DIMES,NICKELS ) 5 
001600 COUNT = COUNT + 13 

001700 END; 

001800 END; 

001900 END; 

002000 END COINS; 

HRI IIE PHI IEE IEE EIEN IIE IE HEI NEIEININEM BOTTOM OF DATA 2¢06363636969696 969696265661 IEIEIE IE IE HE IEIE IE HEE IE IE DE 





Figure 28. Edit - repeat line example 
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Moving and Copying Lines 
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To move a line, the single character "M" is entered in the line 
command area of the line to be moved, and the character "A" Caf- 
ter) is entered in the line command area of another line, indicat- 
ing the destination of the move. When the ENTER key is pressed; 
the line containing the "M" is moved immediately following the 
line containing the "A". Alternatively, the destination may be 
indicated with a "B" (before) Line command, in which case the line 
containing the "M" is inserted immediately preceding the line 
containing the "B", 7 


~ Move line 


~ Move "n"™ lines 
~ Move block of lines 





Cc ~ Copy line 
Cn - Copy "n" lines — 
Co Oo «Copy block of lines 


After this line 
After this line and repeat "n™ times 
Before this line 
Before this line and repeat "n” times 





A number may follow the "M" to indicate that more than one line is 
to be moved. A block of lines to be moved is indicated by enter- 
ing the double character "MM" on the first and last lines to be 
moved. The first and last lines to be moved, and the destination 
line may all be on separate pages. 


A number may also follow the "A™ or "B"™ Line command to cause the 
moved line€s) to be repeated the designated number of times at the 
point of destination. 


The procedure for copying lines is the same as for moving lines, 
except that a "C" or "CC" line command is used in place of the "M" 
or "MM". The copy operation leaves the original line(s) in place, 
and makes a duplicate copy at the indicated destination. 


Figure 29 shows a before-and-after example of copying lines. The 
block of lines starting at line 800 through line 1500 is copied to 
follow line 1900. 
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EDIT -~- SPFDEMO.MYLIB.PLI(TESTDIR) - 01.03 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
IF ERROR-FLAG THEN 
DO; 
PUT FILECSYSPRINT ) 
EDIT( ‘TEST NOTES ERROR RETURN FROM D-I-R') 
(COLUMN(213,A034))3 
PUT FILE(SYSPRINT) SKIP(2) 
DATA( ERROR-FLAG, CARD-IMAGE ; ANSWER) $ 
ERROR-FLAG = '0'B; 
END 3 
ELSE 
$ 
001800 END; 
AL ELSE 
002000 ; 
002100 END; 
002200 END TESTDIR; 
HHHHHH HH HHH HEHEHE HIM HEHE HEHE HHH KHKHIEN BOTTOM OF DATA 3656363363696 3696 9696 IE IEEE IE TE IE IE HE EEE ETE E 


EDIT --~ SPFDEMO.MYLIB.PLICTESTDIR) - 01.03 ---<--------~- ~~~ COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
000700 IF ERROR-FLAG THEN 

000800 bo; 

000900 PUT FILECSYSPRINT) 

001000 EDIT('TEST NOTES ERROR RETURN FROM D-I-R‘) 

001100 (COLUMN( 21),A0343)5 

001200 PUT FILE(SYSPRINT) SKIP(2) 

001300 DATA( ERROR-F LAG, CARD- IMAGE » ANSWER ) 3 

001400 ERROR-FLAG = ‘'0'B; 

001500 END3 

001600 ELSE 

001700 ; 

001800 END}; 

001900 ELSE 

001910 DO; 

001920 PUT FILEC(SYSPRINT ) 

001930 EDIT( "TEST NOTES ERROR RETURN FROM D~-I-R') 

001940 (COLUMN( 21) ,A034))3 

001950 PUT FILE(SYSPRINT) SKIP(2) 

001960 DATA( ERROR-F LAG, CARD-IMAGE » ANSWER } 5 

001970 ERROR-FLAG = '0'B; 

001980 END 

002000 $ 

002100 END; 

002200 END TESTDIR; 

HHH HIE IE SEITEN DERE SESE HE SE HEHEHE BOTTOM OF DATA 3€3636363636396363636 96 96 3E5E SE HE SE TE HEE IE HEE DE IESE ETE 





Figure 29. Edit - copy lines example 
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ules for Enterin ine Command 
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The following rules apply to all edit Line commands. 


Several line commands as well as data modifications may be typed 
before pressing the ENTER key. Error messages will be displayed 
in cases where multiple line commands are ambiguous. If an erro-~ 
neous or unwanted line command is entered, it may be undone by 
simply blanking it out or by using the RESET primary command. 


In most cases, only the first one or two characters of the line 
number need be overtyped to enter a line command. For example, if 
line 700 is to be repeated, a single "R" may be typed: 


000600 
RO0700 
000800 


In some cases, however, typing a single character may be ambig- 
uous. In the following example, it is unclear whether the user 
has typad a single "R" to repeat Line 31766, or *K3* to repeat the 
line three times. 


031600 
R31700 
031800 


In such cases, edit assumes that the user has not entered a number 
following the line command. If the user meant to repeat the line 
three times, he may use any of the following procedures. 


1. Leave the cursor on the character immediately following the 
MR3™: R31700 


2. Type one or more blanks following the "R3": R3 700 


3. Type "R3" and then press the ERASE EOF key to clear the rest 
ae line number field Cor press ERASE EOF before typing 


Three line commands may be entered on the "TOP OF DATA" line by 
overtyping the asterisks which normally appear in its line number 
field. They are: | 


Ior In - see one or more lines ahead of the rest of the 
data. 


Aor An - to move or copy Lines ahead of the rest of the data. 


TE or TEn - to enter one or more lines of text ahead of the rest 
of the data. 


One line command may be entered on the "BOTTOM OF DATA" line by 
overtyping the asterisks, namely: 


B or Bn ~ to move or copy lines following the rest of the data. 


Hints on use of cursor keys: Use the NEW LINE key to move the cur- 
sor to the line command area of the next line. If the cursor is in 

: eae area, use the TAB FORWARD key to space over to the 
ata field. 


Note: When a line command or data modification is typed and the 
ENTER key is pressed, edit will frequently reposition the cursor 
to another line number or to another location within the data. 
Edit attempts to guess the most appropriate position for the cur- 
sor, based on the previous user action. To assist the user in 
locating the cursor, edit intensifies the line number field on the 
line that contains the cursor. 





SPF/CMS PROGRAM REFERENCE MANUAL 


GENERAL COMMANDS 


The following commands are described in this section: 


LOCATE AUTONUM RESET 
NUMBER STATS SUBMIT 
RENUM PRINT SAVE 
UNNUM RECOVERY CANCEL 


These are all "primary" commands, entered in the command input 
field on line 2. 


Locating Lines 


The LOCATE command performs up or down scrolling, as required, to 

a specified line number. If the specified line is not found, 
cree is to the line which precedes the specified line number. 
ormat: 


LOCATE line-number 





Command abbreviations: LOC, L 


The "lLine-number™ operand is a numeric value of up to eight digits 
Cleading zeros need not be typed). If the operand contains six or 
fewer digits, it refers to the line-number fields displayed at the 
left of each line. (For numbered data, these fields reflect the 
sequence numbers in the data records. For unnumbered data, these 
fields show relative line numbers.) If the line-number operand 
contains eight digits, it refers directly to the sequence numbers 

in the data records, including the "modification flag” for SPF 
libraries (see below). 


Sequence Number Generation and Control 


When operating in NUMBER mode, edit automatically generates 
sequence numbers on new lines that are created by insert or copy 
operations, and automatically renumbers the data when it is saved 
Cprovided AUTONUM mode is also in effect). 


Sequence Number Format 


Sequence numbers may be generated in the "standard™ sequence 
field, the COBOL sequence field, or both. The standard sequence 
field is either the last eight characters (for fixed length 
records) or the first eight characters (for variable length 
records), regardless of the programming language. The COBOL 
sequence field is always the first six characters of the line, and 
is valid only for fixed length records. 


For members of SPF libraries, the format of "standard™ sequence 
numbers is dependent on whether SPF statistics are being gener- 
ated. If STATS mode is in effect, standard sequence numbers are 
six digits in length, followed by a two-digit "modification 
flag". The flag reflects the modification level of the member 
when the line was created or last changed. If, for example, a 
sequence number field contains 00040002, the line was added or 
last changed at modification level 02. The sequence number is 
000400. When a new member is created with SPF statistics, the 
modification flags are all set to 00, since the modification level 
is initialized to zero. : 


EDIT COPTION 2) 57 


If STATS mode is off, or if a CMS file is being edited, standard 
sequence numbers are eight digits in length (Cright justified 
within the field). COBOL sequence numbers are always six digits 
in length, and are unaffected by the setting of STATS mode. 


Sequence numbers normally start at 100 and are incremented by 100. 
When inserting lines, edit will drop down to the tens or units 
position and, if necessary, renumber one or more succeeding lines 
to keep the sequence numbers in order. 


Initialization of NUMBER Mode 


As data is fetched for editing, it is examined to determine 
whether or not it contains sequence numbers. The standard 
sequence field is always examined. The COBOL sequence field is 
also examined if the SPF library type or CMS filetype is COBOL 


If all lines contain numeric characters in either the standard or 
COBOL sequence field positions Cor both), and if the numbers are 
in ascending order, edit assumes the data is numbered and turns an 
NUMBER mode. Otherwise, edit turns off NUMBER mode. 


If the initial setting of NUMBER mode differs from the previous 
setting in the profile, a message will be displayed indicating 
that edit has changed the mode. For new files or members, the 
initial satting of NUMBER mode is unchanged from whatever is spec~ 
ified in the profile. The default for a new profile is NUMBER 
mode ON for standard sequence fields, and for COBOL Mieids if the 
type is COBOL. 


Controlling Sequence Numbering 
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pees mode may be turned on or off by using thea NUMBER command. 
ormat: 


NUMBER [CON/OFF] [STD] [COBOL] 


Command abbreviation: NUM 
Keyword abbreviation: COB (for COBOL) 





The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The STD and COBOL operands are inter- 
preted only when NUMBER mode is turned on. If STD typed, the data 
will be numbered in the standard sequence field. If COBOL is 
typed, the data will be numbered in the COBOL field. If both 
operands are typed, the data will be numbered in both fields. If 
both operands are omitted, the default is STD unless NUMBER mode 
was already in effect, in which case the data will be numbered in 
whichever field(s) were previously being numbered. 


Note: If both STD and COBOL numbers are being generated, the STD 
number is determined and then used as the COBOL number. This can 
result in COBOL numbers which are out of sequence if the COBOL and 
STD fields are not synchronized. Use the RENUM command (see 
below) to force synchronization. 


When NUMBER mode is turned on, the NUMBER command verifies that 
all lines have valid numbers that are in ascending sequence. It 
renumbers any lines that are either unnumbered or out of sequence, 
but does not otherwise alter existing sequence numbers. 
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Three additional commands, RENUM, UNNUM, and AUTONUM, are avail- 
able to assist with number generation and control. 


The RENUM command immediately renumbers all lines, starting with 
Hulse 1090 and incrementing by 100, and also turns on NUMBER mode. 
ormat: 


RENUM CSTD] [COBOL] 


Command abbreviation: REN 
Keyword abbreviation: COB (for COBOL) 





The meaning of the STD and COBOL operands is the same as for the 
NUMBER command. 


The UNNUM command sets all sequence fields to blanks and also 
turns off NUMBER mode. It is valid only when NUMBER mode jis cur- 
rently on. The fields to be blanked are either the standard 
sequence field, the COBOL sequence field, or both, depending what 

hi De oNaEy being numbered prior to issuing the UNNUM command. 
ormat: 


Command abbreviation: UNN 


The UNNUM command uses no operands. 


The AUTONUM command controls the setting of AUTONUM mode. When 
this mode is on, the data is automatically renumbered whenever it 
is saved, provided NUMBER mode is also on at that time. 


Secehrak mode may be turned on or off by using the AUTONUM command. 
ormat: 










AUTONUM [ON/OFF] 


If the operand is omitted, ON is the default. 


Statistics Generation 


Generation of SPF statistics for a member of a an SPF library is 
controlled by STATS mode. STATS mode is ignored for CMS files. 


If STATS mode is on when the member is saved, the statistics will 

be updated Cor created if the member did not previously have sta- 

tistics). If STATS mode is off when the member is saved, no sta- 

tistics are stored and any previous statistics are destroyed. See 

pena B for more information about the maintenance of SPF sta- 
istics. 


STATS mode may be turned on or off by using the STATS command. 
Format: : 


STATS CON/OFFI 


If the operand is omitted, ON is the default. 


Whenever a member is fetched for editing, SPF will check the set- 
ting of STATS mode. If STATS mode is off and the member has sta- 
tistics, SPF will automatically turn on STATS mode and display a 
message indicating that the mode has been changed. If STATS mode 
is on and the member has no statistics, a message will be dis~- 
played but the mode will remain unchanged. 
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When a new member is created, the initial setting of STATS mode is 
unchanged from whatever is in the profile. The default for a new 
profile is STATS mode ON. 


The generation of SPF statistics also affects the format of 
sequence numbers, as discussed under "Sequence Number Generation 
and Control". 


Automatic Source Listings 


The automatic generation of source listings is controlled by 
PRINT mode. If this mode is on when edit is terminated via the End 
or Return PF key, and if the data has been changed, a source list~ 
ing . the data will be recorded in the SPF list file for eventual 
printing. 


PRINT mode may be turned on or off by using the PRINT command. 
Format: 


PRINT CON/OFF] 


If the operand is omitted, ON is the default. 


Recovery Control 
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When edit is operating in RECOVERY mode, an audit trail of user 
interactions is automatically recorded in an SPF~-controlled file. 
Following a system failure, the recovery file may be used to 
replay the edit session. When edit is selected from the primary 
option menu, a special menu is displayed indicating that recovery 
is available (Figure 30). As directed on the menu, the user may 
proceed with recovery, cancel recovery, or press the End PF key to 
return to the primary option menu. 


RECOVERY mode may be turned on or off by using the RECOVERY com- 
mand. Format: 


RECOVERY [ON/OFF] 
Command abbreviation: REC | 


If the operand is omitted, ON is the default. 






Operating with RECOVERY mode off may result in improved response 
time due to the elimination of I/0 operations to maintain the | 
recovery file. If RECOVERY mode is on, the first change to the 
data causes a checkpoint of the data to be written. This may 
increase response time for the interaction, especially if a large 
member or file is being edited. 
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SELECT OPTION ===> _ 


HEHE IEIE IE HEHE HEISE IE HEHEHE IEEE IE IE IEE SE IE IE IE HE DE DEE IE IESE IE SESE IE IEEE 
¥ EDIT AUTOMATIC RECOVERY * 
HEHEHE IEE IEICE HEE HE TE IE IEEE ETE IEICE HIE FER HERE MEIER MHOE 


SPFDEMO.XXX.COBOL(CBLMAIN ) 
WAS BEING EDITED WHEN A SYSTEM FAILURE OR ABEND OCCURRED. 


INSTRUCTIONS: 
PRESS ENTER TO CONTINUE EDITING, OR 
PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU, OR 
ENTER CANCEL ABOVE TO CANCEL RECOVERY AND 
PROCEED TO THE EDIT FILE MENU. 


IF YOU WISH TO PRESS ENTER AND THE MINIDISK IS PASSWORD PROTECTED, SPECIFY: 
READ PASSWORD ===> UPDATE PASSWORD ===> 





Figure 30. Edit - recovery menu 


General Reset 


Edit will display warning messages in the data portion of the dis- 
play if a mode satting has been automatically changed by edit 
after examination of the data, or if the data contains invalid 
characters. Edit also displays line messages to show the current 
setting of edit modes (when the PROFILE command is entered). Dis~ 
play of messages and other special conditions may be reset by 
using the RESET command. Format: 


RESET 


Command abbreviation: RES 





No operands are used for this command. 


The RESET command will: terminate display of all message lines 
and other special lines (COLS, MASK, TABS, and BOUNDS), reset line 
numbers to normal after they were replaced with "==CHG>" or 
WS=ERR>" messages (see CHANGE and shift commands), blank out 
@rroneous or unwanted line commands, and redisplay all excluded 
lines. The RESET command does not change any of the edit modes, 
nor alter the data. 


Note: RESET scans every line of data for conditions to be reset. 


Use of the "D" line command to delete one or more special lines 
may result in faster response time. 
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Submit to Job Stream 


$ 
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The SUBMIT command may be used to submit the data being edited 
Sathabla member or file) to the job stream of another VM machine. 
ormat: 


SUBMIT machine-id 
Command abbreviation: SUB . 


The operand is required to specify the VM machine to which the 
data is being submitted. It may specify a CMS batch machine, or a 
¥VS or DOS machine. 


Note: SPF does not supply a job statement when the edit SUBMIT 
command is invoked. The user may supply job statement(s) as part 
of the data being submitted. 






nd Cance 


The SAVE command may be used to save the edited data without ter- 
minating edit, and the CANCEL command may be used to terminate 
edit without saving the data. Formats: 


SAVE 


CANCEL 


Cammand abbreviation: CAN 





No operands are used for these commands. 


Note: As a general rule, use of the SAVE command is not necessary 
if RECOVERY mode is on. 


The SAVE command writes the data back to the same file or member 
from where it was fetched, except when a concatenated sequence of 
SPF libraries has been specified. In this case, the data is saved 
in the first library of the concatenation sequence regardless of 
which library it came from. For a sequential file, the entire 
file is rewritten. For an SPF library, MACLIB, or TXTLIB, the 
member is rewritten with the same member name. The statistics for 
a member of an SPF library are automatically updated Cprovided 
STATS mode is in effect). 


The data is automatically renumbered prior to saving, provided 
both NUMBER mode and AUTONUM mode are in effect. 


If SAVE cannot successfully rewrite the data due to I/0 errors or 
insufficient space on the minidisk, a message is displayed in the 
upper right-hand corner of the screen, accompanied by an audible 
alarm Cif installed). The user may then attempt to save the data 
in another file by taking the following steps: 


1. Enter a CREATE or REPLACE command with no operand on the pri- 
mary command Line. 


2. Enter "€99999" or "™M99999" on the first data line, indicating 
that all lines are to be copied or moved. Then press the 
ENTER key. 


3. Fill in the file or library Cand member) name on the CREATE or 
REPLACE menu, and press the ENTER key. 


See CREATE and REPLACE commands for further information. 
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Alternatively, the user may wish to enter split screen mode and 
attempt to fix the problem by using appropriate utilities, a.g., 
compress or delete, and then retry the save from the edit screen. 


The normal way to terminate edit is by pressing the End or Return 
PF key, which causes the following actions. 


1. 


2. 


3% 


A SAVE is issued if any changes have been made since the data 
was last saved. (The above discussion of I/0 errors also per~- 
tains aoen automatic SAVE when the End or Return key is 
pressed. 


If any saves have occured, the data is recorded in the SPF 
list file Cprovided PRINT mode is in effect). 


Editing is then terminated. 


Note that neither the SAVE nor CANCEL command causes automatic 
Soha in the SPF list file, regardless of the setting of PRINT 
mode. 
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FINDING AND CHANGING CHARACTER STRINGS 


The following commands are described in this section: 


FIND 
CHANGE 


These are both "primary" commands, entered in the command input 
field on line 2. 


The FIND command is used to find one or more occurrances of a 
specified character string, and the CHANGE command jis used to 
change one or more occurrences to another character string. Both 
commands allow special forms of character strings and several 
optional parameters to control: 


° Starting point and direction of search 

° Special conditions to control character string "match" 

° Range and column limitations on extent of search 

The command suiiiary, Which follows, describes the basic forms of 
FIND and CHANGE which are most frequently needed. The remainder 
of this section provides detailed information about the various 
special features and options. 


Command Summary 
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The basic format for FIND and CHANGE is: 


FIND string-1 [ALL] 


Command abbreviation: F 


CHANGE string-1 string-2 [CALL] 
Command abbreviations: CHG, C | 


The operands may be separated by blanks or commas. The ALL oper~ 
and is optional, and may precede or follow either string. 





As a general rule, the strings are typed without delimiters. 
Examples: 


FIND XYZ 
CHANGE ALL ABC IJKL 


to find the next occurrence of XYZ or to change all occurrences of 
ABC to IJKL. 


Strings may be delimited with either apostrophes (') or quotation 
marks ("). Delimiters must be used if a string contains imbedded 
oo or commas, or if a string is the same as a command keyword. 
xamples: 


FIND ‘EVERY ONE’ 
CHANGE ‘EVERY ONE’ ‘ALL' 


to find the next occurrence of "EVERY ONE" or to change the next 
occurrence of "EVERY ONE” to "ALL". 
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If the ALL operand is omitted, the FIND or CHANGE command searches 
for the next occurrence of string-1 starting at the current cursor 
location. (CIf the cursor is not in the data area of the screen, 
scanning starts at the beginning of the first line which is cur- 
rently being displayed.) Scrolling is performed, if necessary, 
to bring the string into view. The cursor is positioned under the 
string (for a CHANGE command, it is positioned at the end of the 
changed string) and a verification message is displayed in the 
upper right-hand corner of the screen. The Find or Change PF key 
ard used to find or change each successive occurrence of the 
string. 


If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED” message is displayed 
and the audible alarm is sounded Cif installed). The Find or 
Change PF key may then be used to wrap to the top of data and con- 
tinue searching. If the string is not found anywhere in the data 
a "NO xxxxx FOUND" message is displayed. 


If the ALL operand is typed, the FIND or CHANGE command searches 
for all occurrences of string-1 starting at the top of the data, 
and positions the cursor under the first occurrence. The verifi-~ 
cation message indicates the number of occurrences found. For a 
CHANGE command, each line on which a change occurred is indicated 
with a "==CHG>" message in the line number field. 


If the two strings specified for a CHANGE command are not the same 

length, automatic shifting is performed by expanding or collaps~- 
ing multiple blank characters to the right of the substitution. 

In no case is data lost. If insufficient blanks exist for 

right-shifting, the original string remains unchanged. This con- 

eras is indicated with a "==ERR>" message in the line number 
ield. 


Following a CHANGE command, the ==CHG> and ==ERR> line messages 
may be reset to normal via the RESET command, or by overtyping the 
line number or data on those lines. 


The Find and Change PF keys may be used together to find each 
occurrence of a character string, examine it, and then” either 
change it (by pressing the Change PF key), or go on to the next 
occurrence (by pressing the Find PF key). To do this, start by 
typing a CHANGE command on line 2 but then, rather than pressing 
ENTER, press the Find PF key. This will position the cursor to 
string~-1 without changing it. Then press Change (to change it to 
string-2) or Find (to get to the next occurrence of string~l). 


Figure 31 shows a before-and-after example of the CHANGE comand. 
All occurrences of the character string NUMERIC are replaced with 
the string NUMERIC-INT. The cursor is repositioned to the end of 
the first occurrence, and a ==CHG> message is displayed at the 
beginning of each changed line. 
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EDIT --~ CBLMAIN COBOL Al COLUMNS 007 078 

COMMAND INPUT ===> CHG NUMERIC NUMERIC-INT ALL_ SCROLL ===> HALF 

003300 DATA RECORD IS O-C. 

003400 O1 O-C. 

003500 02 DUMMY PICTURE X(80). 

005600 WORKING-STORAGE SECTION. 

003700 77 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 

003800 77 PREV-DEVICE-TYPE-CODE PICTURE X VALUE 'I', 

003900 77 PREV-ACTV-CODE PICTURE 9 VALUE 0. 

004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 

004100 C-SWITCH PICTURE X VALUE '0'. 

004200 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 

004300 GSA-REF PICTURE XX. 

004400 UNIT-PRICE-NUMERIC PICTURE $9(83V99. 

004500 BNL-NUMERIC PICTURE S9(8)V99. 

004600 PREV-MODEL PICTURE X(5) VALUE 'O'. 

004700 PG~-COUNT PICTURE 999 VALUE 0. 

004800 PERIOD PICTURE 99 VALUE 0. 

004900 PL-TOTAL-PRICE-NUMERIC PICTURE S9(8)V99 VALUE 0. 
* 065000 PL-TOTAL-BMR~NUMERIC PICTURE $9(8)V99 VALUE 0. 

006100 77 PL-MATNT-REQ-NUM PICTURE SO(4)V9O0 VALUE 0. 

005300 HEADING-SW PICTURE 9 VALUE 1. 

005400 PREV-DEVICE PICTURE X(6) VALUE SPACES. 

005500 PREV-RPQ-FEATURE PICTURE X(10)} VALUE SPACES. 

005600 TEMP-MAINT PICTURE S9(7)V99 VALUE 0. 

005700 TOTAL~BMR PICTURE 59(8)V99 VALUE 0. 

005800 TOTL-PR PICTURE 39(8)V99 VALUE 0. 

005900 TOTAL~MAINT PICTURE $9(7)V99 VALUE 0. 


EDIT --- CBLMAIN COBOL Al CHARS 'NUMERIC’ CHANGED 
COMMAND INPUT === SCROLL ===> HALF 
003300 DATA RECORD IS O-C. 

003400 O01 O-C. 

003500 02 DUMMY PICTURE X(80). 

003600 WORKING-STORAGE SECTION. 

003700 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 
003800 PREV-DEVICE-TYPE-CODE PICTURE X VALUE '‘I'. 

003900 PREV-ACTV-CODE PICTURE 9 VALUE 0. 

004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 

004100 C~SWITCH PICTURE X VALUE '0'. 

004200 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 

004300 GSA-REF PICTURE XxX. 

==CHG> UNIT~PRICE-NUMERIC-INT_PICTURE $9(8)V99. 

==CHG>- BML-NUMERIC~-INT PICTURE S9(8)V99. 

004600 PREV~-MODEL PICTURE X(5) VALUE ‘0’. 

004700 PG-COUNT PICTURE 999 VALUE 0. 

004800 PERIOD PICTURE 99 VALUE 0. 

==CHG> PL~TOTAL-PRICE-NUMERIC-INT PICTURE S9(8)V99 VALUE 0. 
==CHG> PL-TOTAL-BMR-NUMERIC-INT PICTURE S9(8)V99 VALUE 0. 
005100 PL-MAINT-REQ-NUM PICTURE S9(4)V99 VALUE 0. 

005300 HEADING-SW PICTURE 9 VALUE 1. 

005400 PREV-DEVICE PICTURE X(6) VALUE SPACES. 

005500 PREV-RPQ-FEATURE PICTURE X(10) VALUE SPACES. 

005600 TEMP~MAINT PICTURE S9(7)V99 VALUE 0. 

005700 TOTAL-BMR PICTURE S$9(8)V99 VALUE 0. 

005800 TOTL~PR PICTURE $9(8)V99 VALUE 0. 

005900 TOTAL-MAINT PICTURE S9(7)V99 VALUE 0. 





Figure 31. Edit - CHANGE ALL command example 
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The complete formats for FIND and CHANGE, showing all optional 
parameters, are as follows: 


FIND string-l NEXT/ALL/FIRST/LAST/PREV] 
CHARS/PREFIX/SUFFIX/WORD] 


[col-2]] 


Command abbreviation: F 
Keyword abbreviations: PRE (for PREFIX), SUF (for SUFFIX) 


CHANGE string-1l string-2 ([NEXT/ALL/FIRST/LAST/PREV] 
[ CHARS/PREFIX/SUFFIX/WORDJ 
LX/NX] 
[Ccol-1 [Ecol-2]] 


Command abbreviations: CHG, C 
Keyword abbreviations: PRE (for PREFIX), SUF (for SUFFIX) 





Note that FIND under edit has the same format as FIND under 
browse, except for the optional X/NX parameter. 


The operands may be separated with blanks or commas, and may be 
typed in any order except that string-2 (for CHANGE) must follow 
string-1l, and col-2 Cif typed) must follow col-1. The string~-1 
eel ke required Cand string-2 for CHANGE); the others are 
optional. 


The "string-1" operand specifies the string to be found. It may 
be specified in any one of the following forms: 


° Any string of characters not starting or ending with an apos~- 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 


° A delimited string: Any string starting and ending with an 
apostrophe (') but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain- 
ing imbedded quotation marks. 


° A hex string: Any delimited string of valid hexadecimal char- 
or esa: preceded or followed with the character X. Example: 
278 


© A text string: <Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings.” Example: T'conditions for' 


° A picture string: Any delimited string of picture charac~ 
ters, preceded or followed with the character P. See dis- 
cussion under "Use of Picture Strings." Example: P’.' 


° A single asterisk (*%). This causes the previous value that 
was used as string-1 in either a FIND or CHANGE command to be 
used again. 

The "string-2" operand is required for the CHANGE command to spec~ 

ify the new value of the string. The rules for coding string-2 

are the same as for string-1, except as follows: 

1. <A text or picture string may not be specified for string-2. 


2. If a single asterisk is typed, the previous value of string-2 
that was used in a CHANGE command is used again. 
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The previous value of a character string (referenced via * or used 
by the Find/Change PF keys) is retained until the edit option is 
terminated Ci.e., until return to the primary option menu). 


Starting Point and Direction of Search 


The starting point, direction and extent of the search may be 
controlled by one of the following operands. 


NEXT Scan starts at the current cursor location and proceeds 
forwards to find the next occurrence of string-l. 


ALL Scan starts at the top of data and proceeds forwards to 
find all occurrences of string-1. 


FIRST Scan starts at the top of data and proceeds forwards to 
find the first occurrence of string-1. 


LAST Scan starts at the bottom of data and proceeds backwards to 
find the last occurrence of string-l. 


PREV Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of string-1. 


If this operand is omitted, the default is NEXT. 


If the direction of the search is forward (i.e, if FIRST, ALL, or 
NEXT was specified), pressing the Find or Change PF key finds or 
changes the next occurrence of the designated string. If the 
direction of the search is backward Cif LAST or PREV was speci- 
fied), pressing these PF keys finds or changes the previous occur- 
rence of the string. The other optional parameters (CHARS, WORD, 
PREFIX, SUFFIX, X, NX, and col-1, col-2) remain in effect, as 
specified in the last FIND or CHANGE command. 


The search proceeds until one or all occurrences of string-~l are 
found, or until the end of data is encountered. If string-1 is 
not found, one of the following actions takes place. 


° For FIRST, LAST, or ALL - a "NO xxxxx FOUND" message is dis~ 
played in the upper right-hand corner of the screen. 


° For NEXT ~- a "BOTTOM OF DATA REACHED" message is displayed. 
® For PREV - a "TOP OF DATA REACHED” message is displayed. 


When "BOTTOM OF DATA REACHED” or "TOP OF DATA REACHED” is dis- 
played, the user may press the Find PF key (for either FIND or 
CHANGE) or the Change PF key (for CHANGE) to continue searching by 
wrapping to the top (or bottom) of the data. If no occurrence is 
UO oenars in the data, a "NO xxxxx FOUND" message is dis- 
played. 


Conditions for Character String Match 
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The conditions for a successful "match" with string-1 may be 
controlled based on whether the data.string begins and/or ends 
with a non-alphameric character Ci.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF), and WORD. In the following 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 
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CHARS 'DO' DO DO DO pO DO (DONT) 
PREFIX 'DO' (DONT) 


SUFFIX 'DO' DO (DONT) 


WORD ‘DO! po (DONT) 





If this operand is omitted, the default is CHARS. 


Range and Column Limitations 


Under edit, the lines to be searched may be limited by first using 
the "X" or "XX" line commands (see "Excluded Lines"), and then 
specifying one of the following operands on the FIND or CHANGE 


command: 
X - Scan only lines which are excluded from display. 
NX ~- Scan only lines which are not excluded from display. 


If this operand is omitted, both excluded and non-excluded lines 
will be searched. When an excluded line is searched and string-1 
is found, the line is automatically redisplayed Ci.e., it is 
"popped" out from the block of excluded lines). 


Note: The X/NX operand is not defined when using FIND under 
browse. 


If the "col-1" and "col-2" operands are typed Ctwo integers sepa- 
rated by a comma or at least one blank), they indicate the start- 
ing and ending column positions for the search. If col-1l is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1 nor col-2 is 
specified, the search will continue across all columns within the 
current boundary columns. See description of BOUNDS commands. 


Use of Text Strings 


A text string, which may be used as string-1 in a FIND or CHANGE 
command, allows the search to be satisfied without regard to 
upper/lower case alphabetics. Example: FIND T'CONDITION NO. 1" 
would successfully find any of the following: 


CONDITION NO. 1 
Condition No. 1 
condition no. lL 
cCONDItION nO. 1 


An ordinary delimited string, such as: FIND "CONDITION NO. 1! 
would find only the first example listed above. 


Within the text string itself, is is immaterial whether alphabet- 
ics are typed in upper or lower case Ceven if CAPS mode is off). 
For example, all the following have the same effect: 


FIND T*°Edit Commands’ 


FIND T'EDIT COMMANDS* 
FIND T'edit commands’ 
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Use of Picture Strings 
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A picture string, which may be used as string-1 in a FIND or 
CHANGE command, allows the search to be satisfied when a partic~ 
ular type of character is encountered. Special characters are 
used within the picture string to represent the type of character 
to be found, as follows: 


STRING MEANING 





P'=" - any character (don't care) 

P¥-" = any non~blank character 

P*.,*" - any non-displayable Cinvalid) character 

P'#" - any numeric character (0-9) 

P'-"' - any non-numeric character 

Pra’ - any alphabetic character Cupper or lower case) 
P*<* - any lower case alphabetic character 

P'>" - any upper case alphabetic character 

P'S" = any special character (not alpha or numeric) 


Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters, in which case the characters 
represent themselves. 


Examples of picture strings: 


P'###"' - a string of three numeric characters 

P'> =" - any two non-blank characters surrounding a blank 
PS - any non-displayable character 

Doetnt - a blank followed by a numeric character 


a numeric character followed by "AB* 


Examples of FIND and CHANGE commands using picture strings: 


FIND P*.* ~ find next non-displayable character 
FIND P’-' 72 ~ find next non-blank character 
in column 72 
C ALL P*=* * * 73 80 - change any characters in columns 
73-80 to blanks 
Fipe se 7h - find the next line with a blank in 


column 1 followed by a non-blank 


When the picture string P*.' is used to find or change a 
non-displayable character, the hexadecimal representation of the 
character is shown in the confirmation message which appears in 
the upper right-hand corner of the screen. 
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ADVANCED FEATURES 


The following commands are described in this section. 


Line commands: 


MASK X Cexclude) 
< (data left) S (Cshow) 
> (data right) F Cfirst) 
¢ Ccolumns left) L (last) 
> Ccolumns right) TABS 
BOUNDS 

Primary commands: 
COPY NULLS 
MOVE TABS 
CREATE PROFILE 
REPLACE HEX 


Mask Definition 


The mask is used in conjunction with the "I" Cinsert), "TE™ (text 
entry), and "TS" (text split) line commands. Whenever a new line 
is inserted, it is pre-filled with the contents of the mask. Ini- 
tially, the mask contains all blanks. 


To display the mask, the characters "MASK" are entered in the line 
command area, overtyping the line number. When the ENTER = is 
pressed, the mask is displayed at the designated position. 


MASK - Display mask definition line 


Once displayed, the mask may be changed to allow pre-entry of data 
on inserted lines. An example is shown in Figure 32. In this 
example, the mask has been displayed and the characters "/*" and 
"¥/" have been entered at the desired positions on the mask line. 
Five new Lines are then inserted following line 1709. The second 
Apel baits example shows that the new lines contain the contents 
o e mask. 


The mask line may be removed from display by entering a "D" in the 
line command area, or by entering a RESET primary command. The 
mask Line is never saved as part of the data. 


The mask remains in effect Ceven if it is not displayed) until it 
is again changed by the user. The contents of the mask are 
retained in the current edit profile, and automatically used the 
next time the user edits the same type of data. 
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EDIT --~ SPFOEMO.SAMPLE.PLICEDO921PM) ~ 01.01 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
001100 ELSE 
001200 COMPUTE PARM LENGTHS 
001300 
=COLS> 
=MASK> 
001400 
001500 DO WHILE (CEDOMPROJCLP) 
LP = LP~1}3 
END; 
DO K=1 TO 43 
IF EDOMLIB(Ks1) ~= ' 
DO; 
LUCK) = 83 
DO WHILE 
CEDOMLIB(K,LLOK)) = ' "23 
LLOK) = LLCK)-13 
END; 
END3 
ELSE 
LLCK) = 03 
END3 
END; 
RETURN CODE(0); 
END EDd21PM3 
DEIEIEE IEE SEW IEDEIESEIE IE IE IE IEE IEEE TENE EIEN IEE BOTTOM OF DATA 2€96263636 366 IEE IEE IEE IE IE IE IE TENE IE IE NE IEICE DEIETE 


EDIT ~-- SPFDEMO.SAMPLE.PLICEDO2IPM) ~ 01.01 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
001100 ELSE 

001200 /%* COMPUTE PARM LENGTHS 

001300 

SCOLS> wwe n tenn lene ten nn Qe nn tenn Je = 

=MASK> 

001400 

001500 DO WHILE (EDOMPROJCLP) 

001600 LP = LP-13 

001700 END; 


001800 DO K=1 TO 43 

001900 IF EDOMLIB(K,1}) -= ' 
002000 DO; 

062100 LL(K) = 83 

002200 DO WHILE 

002300 (EDOMLIB(K,LLEK)) = * 995 
002400 LL(K) = LECK)-1;3 
002500 END; 

002600 END; 

002700 ELSE 

002800 LL(IK) = 03 

002900 END; 





Figure 32. Edit - define mask example 
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Indentation Changes 


The contents of a line (or block of lines) may be shifted left or 
right by means of the shift line commands. The two forms of these 
commands are: 


m>" and "<" for "data™ shifting 
")" and "cc" for "column" shifting 


Data shifting attempts to shift the body of a program statement 
without shifting the label or comments, and will prevent loss of 
data. Column shifting shifts information without regard to its 
contents, and may result in the loss of data. (See further dis- 
cussion below.) | 


To shift the contents of a line left, the single character "<" or 
"CC" is entered in the line command area, overtyping the line num- 
ber. When the ENTER key is pressed, the data in the line contain- 
ing the command is shifted left by two column positions (two is 
the default for shift operations). 


shift line Left 2 positions 

shift line left "n" positions 

shift block of Lines left 2 positions 
shift block of lines left "n"™ positions 


shift line left 2 positions 

shift line left "n" positions 

shift block of lines left 2 positions 
shift block of lines left "n" positions 





To shift a block of lines left, "<<" or "C(C(" is entered in the 
line command area of the first and last lines to be shifted. The 
first and last lines need not be on the same page; scrolling may 
be used between entering the first command and the second command. 


Sao ees commands for right shifting are ">", ")"™, ">>" and 
Ww 


shift line right 2 positions 

shift line right "n" positions 

shift block of lines right 2 positions 
shift block of lines right "n"™ positions 


line right 2 positions 

line right "n" positions 

block of lines right 2 positions 
block of lines right "n" positions 





A number may be entered following any of the shift commands to 
indicate the number of column positions to be shifted. For exam- 
ple, ">>5" entered on the first or last (Cor both) lines to be 
shifted would cause a right shift of five column positions. 


Shifting occurs within column boundaries that may be changed by 
the user. Default column boundaries are established by edit, 
based on the data "type" (SPF library type or CMS filetype). The 
default boundaries are normally the first and last columns where 
source text may be entered for the particular programming lan- 
guage. See BOUNDS command for a discussion of default boundaries 
and the procedures for changing them. 
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Data Shifting - ">" and "<" 


Within the column boundaries, data shifting is accomplished by 
squeezing out multiple blank characters at one end of the data, 
and increasing the number of blanks at the other end. The follow- 
ing rules are followed in performing a data shift. 


° Non-blank characters are never deleted or truncated. 
e A single blank is never deleted. 


° Within apostrophes, the number of multiple blanks is never 
changed. 


° Non~-blank characters are never shifted into or out of the left 
column boundary position (normally the label field). 


° If a shift cannot be completed, it is partially performed and 
the line number jis replaced with the following. intensified 
warning message: ==ERR>. The warning message may be removed 
via the RESET primary command, or by overtyping the message or 
data on that line. 


Figure 33 shows a before-and-after example of data shifting. The 
block of lines, starting at Line 1910 through line 1980, is 
shifted left four column positions. 


Column Shifting - ")" and "(" 
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Column shifting is accomplished by simply moving all of the 
characters (within the column boundaries) left or right by the 
designated number of positions. There is no squeezing or increas~ 
ing of blanks. There jis no restriction on shifting non-blank 
characters into or out of a column boundary position. Characters 
shifted beyond a column boundary postion are lost, with no warning 
message. 
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EDIT --~ SPFDEMO.MYLIB.PLICTESTDIR) ~ 01.03 ~----------e2e n= COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
001800 END} 
001900 ELSE 
Ke<q bo; 
0019206 PUT FILE(SYSPRINT) 
001930 EDIT( ‘TEST NOTES ERROR RETURN FROM D-I-R') 
001940 (COLUMN( 21 ),A0343 3 
001950 PUT FILECSYSPRINT) SKIP(2) 
001960 DATAC ERROR~F LAG, CARD-IMAGE » ANSWER } 3 
ERROR-FLAG = ‘O'Bs 
END}; 
$ 
END; 

602200 END TESTDIR; 
JEIEIEIEIENE 9696369696 9C 96 96 96 IEICE IEE IEE 9EHEIEIEIEIENEIEIIEN BOTTOM OF DATA 2€36262636969636969626969636 6963696 3626 EEE ICIEIEIEIENE 


EDIT --- SPFDEMO.MYLIB.PLI(TESTDIR? - 01.03 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
001800 END; 

001900 ELSE 

GO1910 DO; 

001920 PUT FILE(SYSPRINT) 

001930 EDIT( 'TEST NOTES ERROR RETURN FROM D-I-R') 

001940 (COLUMN( 21) AC34))3 

001950 PUT FILE(SYSPRINT) SKIP(2) 

001960 DATA( ERROR-FLAG», CARD-IMAGE , ANSWER ) 5 

001970 ERROR-FLAG = '0'B3 

0019890 END; 

002000 ; 

002100 END; 

002200 END TESTDIR; : 

HEHEHE HEI PEI TE IE IE IE ETE IE HE HE ETE IEIE IE EIEN MWIHNIENW BOTTOM OF DATA 3€3696369696969696362626 56 0636 36 HIE HE TEE TEE IE IE ETE DEE 





Figure 33. Edit ~ left shift data example 
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Boundary Column Definition 
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To display the column boundary definition line, the characters 
WBOUNDS" Cor an acceptable abbreviation) are entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, the boundary definition line is inserted at the desig~ 
nated position. 


BOUNDS - Display boundary definition line 
Command abbreviations: BOUND, BNDS, BND 





The column boundaries are used to limit the scope of: 


e 


Left and right shift line commands 

FIND and CHANGE commands when explicit columns were not spec- 
ified by the user 

Overlay line command 

Text entry, text split, and text flow line commands 

Left and right scrolling. 


© @ 


The effect on left and right scrolling is as follows: 

1. A left scroll will stop at the left bound, anda right scroll 
will stop at the right bound. A subsequent left or right 
scroll will go beyond the bound Cassuming the bound is not at 
the left-most or right~most column position). 

2. The initial display (when edit is entered) will be 
pre~scrolled so that the left boundary column is the first 
column displayed. 

The boundaries are initialized by edit based on the data "type" 

CSPF library type or CMS filetype) and whether or not the data is 


sequence numbered. The default left and right column boundaries 
are shown in Figure 34. 


RECORD DATA 
FORMAT TYPE NUMBERED UNNUMBERED 
eee ee eed 


FIXED . ASM or 
LENGTH ASSEMBLE 1, 71 1, 71 
COTHER } 1, LRECL-8 1, LRECL 


(ANY) 9, LRECL 1, LRECL 


Figure 34. Edit - default column boundary settings 








VARIABLE 
LENGTH 
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The user may change the boundaries by displaying the boundary 
definition line and changing its contents. The boundary defi- 
nition line contains a single "<" character indicating the posi- 
tion of the left column boundary, and aie single ">" character 
indicating the position of the right column boundary. If the user 
has already changed the boundaries, he may revert to the default 
bounds by displaying the boundary definition line and blanking 
out its contents. The ERASE EOF key may be used for this purpose. 


If the default boundaries are in effect, they are automatically 
adjusted whenever NUMBER mode is turned on or off. If the user 
has changed the bounds from the default settings, they are not 
affected by the setting of NUMBER mode. 


Figure 35 shows an example of the boundary definition line 
displayed together with the column identification line. In this 
example, the left bound is currently set at column 42 and the 
right bound at column 70. 


The boundary definition line may be removed from display by enter- 
ing a "D" in the Line command area, or by entering a RESET primary 
tea The boundary definition line is never saved as part of 
the data. 


The boundary definition line is retained in the current edit pro- 
file, and automatically used the next time the user edits the same 
type of data. 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.00 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
001400 IF BROSMEMB(1) -= ' ' THEN 7% IF MEMBER SELECTED, | */ 
001500 DO; 7% 

001600 ZINCLUDE SYSLIB(BROFINDM ) 3 7% FIND MEMBER 

ECOLS> sen m tern wen ten 2m fon Jen pe mend ww pe mene Gam n pen G mmm ban 
=BNDS> < 

001700 IF BRORCODE = 0 THEN 7* IF NO ERRORS; 

001800 DO;. 7® 

001900 ZINCLUDE SYSLIB(CBROPDSH ) 37% SET UP PDS HEADER 
002000 CALL CBRO (TLD,TDC); 7® CALL COMMON BROWSE 
002100 END 7% 

002200 ELSE 7% ELSE, 

002300 BROMLIST = OFF; 7% TURN OFF LIST FLAG 


002400 END 3 7% 

002500 ELSE 7* ELSE (NOTHING SELECTED ),*/ 
002600 BROMLIST = OFF; 7% TURN OFF LIST FLAG %/ 
002700 END3$ 7* END OF LOOP */ 
002800 BROSMENMB = BLANKS; 7* CLEAR SELECTED MEMBER */ 
002900 END; 7% */ 
JERE JEBEB BUEN EEORBEBOO8E BOTTOM OF DATA  369696569696969696969965696369696 962696 96 36969696 969633 





Figure 35. Edit ~- boundary definition line 
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Excluded Lines 
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When editing a program segment which exceeds the screen data size, 
it is often difficult to determine whether the control structure 
and indentation levels are correct. The excluded lines capabili- 
ty allows blocks of lines to be collapsed so that the overall con- 
trol structure may be viewed. The lines are excluded from display 
but are not deleted in the data. 


Excluded lines may also be used in conjunction with the "X" and 
"NX" options of the FIND and CHANGE commands to limit the scope of 
search, and/or to easily identify lines which have been found or 
changed by causing them to "pop out” of a block of excluded lines. 


To exclude a line, the single character "X" is entered in the line 
command area, overtyping the line number. A number may follow the 
"X" to indicate that more than one line is to be excluded. For 
example, "X5" would cause five lines to be excluded, starting with 
the line containing the "X5". When the ENTER key is pressed, the 
line€s) are replaced with a single message line, which indicates 
how many Lines were excluded. 


- Exclude line 


~ Exclude "n"™ lines 
~ Exclude block of lines 





To exclude a block of lines, the double character "XX" is entered 
in the line command area of the first and last lines to be 
excluded. The first and last lines need not be on the same page. 


Figure 36 shows a before-and-after example of excluded lines. 
The block of lines, starting at line 1600 through line 2600, is 
excluded from display and replaced with a single message line. 


Excluded lines may be redisplayed by entering the RESET primary 
command. Alternatively, one or more excluded lines may be redis~ 
played by entering "S" (show), "F" Cfirst), or "L"™ Clast) in the 
line command area of the "EXCLUDED LINES" message, overtyping the 
dashes which are normally in that area. Each of these line com- 
meee eoy be followed by a number to cause redisplay of more than 
one line. 


S ~ Show line 
Sn —- Show "n" Lines 
F ~ Show first line 


Fn ~- Show first "nn" lines 


L ~ Show last line 
Ln ~- Show last "n" lines 
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EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 
COMMAND INPUT ===> 


000700 
000800 
000900 


001000 


001100 
001200 
001300 
001400 
001500 
XX 
001700 
001800 
001900 
002000 
002100 
902200 
002300 
002400 
002500 
XX_ 
002700 
002800 
002900 
003000 
003190 
003200 


ZINCLUDE SYSLIB(BROLISTM)3 
END; 
ELSE 
DO; 
BROMLIST = OFF; 
BROSMEMB = BROMMEMB; 
END; , 
IF BROSMEMB(1) -= ' ' THEN 
DO; 
ZINCLUDE SYSLIB( BROFINDM) ; 
IF BRORCODE = 0 THEN 
00; 
ZINCLUDE SYSLIB( BROPDSH );7* 
CALL CBRO (TLO,TDC); 7% 
END 3 7% 
ELSE 7* 
DO; 7* 
BROMLIST = OFF; 7® 
BROSMEMB = BLANKS; 7% 
END; 7*® 
END}; (* 
ELSE 7* 
BROMLIST = OFF; 7% 
END3 /* 
BROSMEMB = BLANKS; 7% 
END} 7% 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) ~ 01.02 
COMMAND INPUT ===> 


0007006 
000800 
000900 
001000 
001100 
001200 
001300 
601400 
001500 
002700 
002800 
002900 
003000 
003100 
003200 


ZINCLUDE SYSLIB(BROLISTM)3 
END; 
ELSE 
DO; 
BROMLIST = OFF; 
BROSMEMB = BROMMEMB; 
END; 
IF BROSMEMB(1) ~= ' * THEN 
DO; 
END; 
ELSE 
BROMLIST = OFF; 7% 
END; /* 
BROSMEMB = BLANKS; 7% 
END 3 7% 


COLUMNS 001 072 

SCROLL ===> HALF 
LIST MEMBER NAMES */ 
*/ 
ELSE, */ 
xf 
TURN OFF LIST FLAG */ 
MOVE MEMBER NAME TO %/ 
"SELECTED' MEMBER */ 
IF MEMBER SELECTED, %/ 
*/ 
FIND MEMBER */ 
IF NO ERRORS, %/ 
¥/ 
SET UP PDS HEADER */ 
CALL COMMON BROWSE */ 
*/ 
ELSE, *%/ 
*/ 
TURN OFF LIST FLAG ¥*/ 
CLEAR SEL. MEMBER ¥*/ 
*/ 
*/ 
ELSE (NOTHING SELECTED),*/ 
TURN OFF LIST FLAG ¥*/ 
END OF LOOP */ 
CLEAR SELECTED MEMBER */ 
*/ 


COLUMNS 001 072 
SCROLL ===> HALF 
LIST MEMBER NAMES %/ 
%/ 
ELSE, %7 


TURN OFF LIST FLAG 

MOVE MEMBER NAME TO 

‘SELECTED’ MEMBER 
IF MEMBER SELECTED, 


~ 11 LINE(S) NOT DISPLAYED 
*/ 
ELSE (NOTHING SELECTED) ,*/ 
TURN OFF LIST FLAG 
END OF LOOP 
CLEAR SELECTED MEMBER 


JEBHHE. JB BREE UEOORBOEHEEEHEEEEE BOTTOM OF DATA  3363636369636966969696969696969036.969696 9696 30 253096036 


Figure 36. Edit ~ excluded lines example 
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The "S" line command causes the block of excluded lines to be 
scanned, and one or more lines selected for redisplay. The 
selected lines are those with the left-most indentation levels 
Ci.e, with the fewest number of leading blanks). If "S3" is 
entered, for example, the three lines with the left-most indenta- 
tion level will be redisplayed. If more than three lines exist at 
this indentation level, the first three will be displayed. 


The "F"™ line command causes one or more lines at the beginning of 
the block to be redisplayed. The "L™ line command causes one or 
more lines at the end of the block to be redisplayed. 


Figure 37 shows a before-and-after example of redisplaying 
excluded lines. The command "S3" is entered in the line command 
area of the "EXCLUDED LINES” message. Three lines with the high- 
est indentation level are redisplayed. 


Any line command that normally operates on a single line may be 
entered in the line command area of the "EXCLUDED LINES" message. 
For example, a "D" entered on that line will delete the entire 
block of axcluded Lines. This faature is narticularly useful in 


‘conjunction with the shift commands. Suppose, for example, you 


want to "data" shift all lines to the left by 4 column positions. 
Proceed as follows: 


Ls oo the first data line, enter ™X99999", This will exclude all 
ines. 


2. ee WEXCLUDED LINES” message, anter the shift command 
We . 


3. In the primary command area, enter the RESET command to bring 
the lines back into view. 


Note: Excluded lines need not be redisplayed before saving the 
aba ihe WEXCLUDED LINES" message line 1s never saved as part of 
e data. 
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EDIT --~ SPFDEMO.SAMPLE.PLICBROPDS) ~ 01.02 ------- eee ~~~ == COLUMNS 001 072 


COMMAND INPUT ===> SCROLL ===> HALF 
000700 ZINCLUDE SYSLIBCBROLISTM)3 7% LIST MEMBER NAMES */ 
000800 END 5 /*® x7 
000900 ELSE /* ELSE, */ 
001000 DO; 7* */ 
001100 BROMLIST = OFF3 /* TURN OFF LIST FLAG */ 
001200 BROSMEMB = BROMMEMB; /* MOVE MEMBER NAME TO ¥*/ 
001300 END; 7% "SELECTED" MEMBER */ 
001400 IF BROSMEMB(1} == ' ° THEN 7* IF MEMBER SELECTED, */ 
001500 DO; 7% */ 
Pe: SS i= = = et ee ek Fe ee ee eH eh he he he 1 LINECS) NOT DISPLAYED 
002700 END 5 /* */ 
002800 ELSE 7% ELSE (NOTHING SELECTED),*/ 
002900 BROMLIST = OFF3 /*® TURN OFF LIST FLAG */ 
003000 END; 7* END OF LOOP %/ 
003100 BROSMEMB = BLANKS; /* CLEAR SELECTED MEMBER */ 
003200 END $ /* %/ 


FEE OEIC IECIEE IERIE BOTTOM OF DATA 369696969696696969696969696 96 8 969 9 DEINE 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 ------------~---~ COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 
000700 ZINCLUDE SYSLIBCBROLISTM)3 /* LIST MEMBER NAMES %7 
000800 END; (*® */ 
600906 ELSE /* ELSE, ¥/ 
001000 DO; 7% *7 
001100 BROMLIST = OFF; 7% TURN OFF LIST FLAG %/ 
001200 BROSMEMB = BROMMEMB; /* MOVE MEMBER NAME TO ¥*/ 
001300 END3 (* "SELECTED' MEMBER */ 
001400 IF BROSMEMB(1) ~= ° * THEN /* IF MEMBER SELECTED, 

001500 DO; 7* 

891600 ZINCLUDE SYSLIB(BROFINDM)3 7% FIND MEMBER 

001700 IF BRORCODE = 0 THEN 7% IF NO ERRORS; 

7 -- ~~ e we we ee - -~ 4 LINE(S) NOT DISPLAYED 
002200 ELSE /* ELSE, */ 
~- - ss = = = = = = = ee = = 6 & ULINECS) NOT DISPLAYED 
002700 END; 7% */ 
002800 ELSE 7* ELSE (NOTHING SELECTED),*/ 
002900 BROMLIST = OFF; 7% TURN OFF LIST FLAG */ 
003000 END 3 /* END OF LOOP %/ 
003100 BROSMEMB = BLANKS; 7* CLEAR SELECTED MEMBER ¥*/ 
003200 END; 7% */ 
HEHEHE HERE IEE IE IE IEICE HEE IE IEEE HE IEIE CIE NIEMIHHEM BOTTOM OF DATA 236M III IEE ENE HHI IEE EK IEDE 





Figure 37. Edit - show lines example 
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Data Merging and Segmentation 


Merging or segmentation of data is accomplished by moving or copy~ 
ing lines into or out of the data being edited. To merge data, a 
primary command its used to specify the source of the move or copy, 
and a line command is used to specify the destination. To segment 
data, the process is reversed. 


Merging Data 
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The COPY and MOVE primary commands (not be confused with the line 
commands of the same name) are used to specify a sequential file 
or member .of an SPF library, MACLIB, or TXTLIB to be copied into 
the data being edited. If the MOVE command is used, the member or 
file is deleted Cerased) following a successful read operation. 
(For a concatenated sequence of SPF libraries, the delete occurs 
only if the member was in the first library of the concatentation 


saqueanca,y These commands are of the form: 


COPY (Cmember~-name] 
| MOVE [Cmember~-name] 


If the "member-name" operand is entered, the member is fetched 
from the library Cor concatenated sequence of libraries) current~ 
ly being edited. If the operand is omitted, a menu will be dis- 
played to allow specification of a file or Library member as the 
source for the COPY or MOVE. 


The destination for the COPY or MOVE is specified by the "A" Caf- 
ter) or "B" (before) Line command in the data being edited. The 
"TAY or "B™ Line command need not be entered if the data being 
edited contains no lines Cnew or member of file). Note that a 
number may not follow the "A™ or "B" line command when it is used 
in conjunction with a COPY or MOVE primary command. 


If the member~-name operand is omitted on the COPY or MOVE primary 
command, the "A" or "B™ Line command must be entered before the 
ee nets will be displayed Cunless the data being edited contains 
no lines). 


The COPY menu allows a range of lines in the source data set to be 
Pi i Dhae The line searching criteria must also be specified, as 
follows: 


° STANDARD ~ search for 8-character "standard" line numbers 

COBOL ~ search for 6-character COBOL line numbers 

° RELATIVE - ignore line numbers in the data, and interpret the 
specified Line numbers as relative to the start of the data. 


See "Sequence Number Generation and Control" for a further dis- 
cussion of standard and COBOL line numbers. 


Figure 38 shows an example of the COPY command. Member CBLCODE1 
is being edited in library SPFDEMO.XXX.COBOL. A COPY command with 
no operand is entered in the primary command area, and an "A" line 
command is entered at line 500. When the ENTER key is pressed, 
the COPY menu is displayed (second half of the figure). In this 
example, lines 1000 through 2300 of member ENVD in Library 
MASTER.OLD.COBOL are to be copied. When the menu has been filled 
in and the ENTER key pressed, the lines will be copied and 


inserted after line 500, and the edit data will be redisplayed. 
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EDIT --- SPFDEMO.XXX.COBOL(CBLCODE1) - 601.01 COLUMNS 007 078 
COMMAND INPUT ===> COPY SCROLL ===> HALF 
JEXEIEEIEIE 969696969636 9690996 IEEE EIEIEIEIEIEIEIIEE TOP OF DATA 3¢26369636362696909696 9656963636 16656 EEE IEEE IEIE ETE IC IEE 
000100 IDENTIFICATION DIVISION. 

000200 PROGRAM-ID. SMPLCBL - SAMPLE CBL PROGRAM. 

000300 AUTHOR. JOE BLOWN. 

000400 
AL ENVIRONMENT DIVISION. 

000600 

000700 DATA DIVISION. 

000800 FILE SECTION. 

000900 FD SYSPRINT 

001000 LABEL RECORD IS OMITTED 

001100 DATA RECORD IS PRINT-LINE. 

001200 O01 PRINT-LINE. 

001300 02 LINE-FIELD PICTURE X€121). 

001400 WORKING-STORAGE SECTION. 

001500 O01 PRINT-VALUE PICTURE X(121) 

001600 VALUE ' PRINT LINE PRODUCED BY SAMPL 
001700 'E CBL PROGRAM.'. 

601800 

001900 PROCEDURE DIVISION. 

902000 BEGIN. 

002100 OPEN OUTPUT SYSPRINT. 

002200 WRITE PRINT-LINE FROM PRINT-VALUE. 

002300 CLOSE SYSPRINT. 

002400 STOP RUN. 

JRE HE JODIE BREE OEE OCEOEEERIE® BOTTOM OF DATA 236262636:0202630 2020 20200 3026200 IEIEIEIEIEIEIEIEIEIETE 


EDIT - COPY MENU 
“CURRENT” FILE: SPFDEMO.XxXX.COBOL(CBLCODE1] ) 


SPF ‘LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


CMS FILE: 
SPECIFY: 
DEVICE ADDR. ===> LINK ACCESS MODE ===> 
wees (IF PASSWORD PROTECTED) 

LINE NUMBERS (BLANK FOR ENTIRE MEMBER OR SEQUENTIAL FILE): 

FIRST LINE 1000 

LAST LINE 2300 

NUMBER TYPE COBOL (STANDARD, COBOL, OR RELATIVE) 


PRESS ENTER TO COPY OR PRESS END KEY TO CANCEL COPY 





Figure 38. Edit - COPY command example 
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Segmenting Data 
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The CREATE and REPLACE primary commands are used to specify a 
sequential file or member of an SPF library, MACLIB, or TXTLIB to 
be written from the data being edited. CREATE will perform a 
check to ensure that the specified member or file does not already 
exist. REPLACE will either create the member or file Cif it does 
not already exist) or replace it Cif it does exist). The commands 
are of the form: 


CREATE [member-namel 


. Command abbreviation: 


REPLACE [member-namel 


Command abbreviations: 





If the "member~-name"™ operand is entered, the member will be writ~- 
ten in the library currently being edited. (For a concatenated 
sequence of SPF libraries, the member is always written in the 
first library of the concatenation sequence.) If the operand is 
omitted, a menu will be displayed to allow specification of the 
destination of the operation. 


The source of the operation is specified by the "C" (copy) or "M™ 
(move) Line commands. The block form -- "CC" or "MM" -- may be 
used to specify the first and last lines. If the "M" or "MM" line 
command is used, the lines are deleted from the data being edited 
following a successful write operation. The form "Cn™ or "Mn", 
where "n" is a large number, may be used on the first data line to 
copy or move all the data. 


If the member-name operand is omitted on the CREATE or REPLACE 
primary command, the line command(s) designating the source of 
oe Soe ton must be entered before the file menu will be dis- 
played. 


Figure 39 shows an example of. the REPLACE command. Member 
CBLCODE1] is being edited in SPF library SPFDEMO.XXX.COBOL. Lines 
800 through 1700 are to be moved, as indicated with the "MM" line 
commands. The entire contents of file NEWFILE COBOL Al are to be 
replaced with Lines 800 through 1700. 


Note: The data which is written to the destination file is renum- 
bered if both NUMBER mode and AUTONUM are in effect. <A source 
listing of the data is also recorded in the SPF list file for 
eventual printing, provided PRINT mode is in effact. 
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EDIT --~ SPFDEMO.XXX.COBOL(CBLCODE1) ~ 01.01 -----2~------~-- COLUMNS 007 078 
COMMAND INPUT ===> REPLACE SCROLL ===> HALF 
000560 SELECT SYSPRINT 
000570 ASSIGN TO UT-S~PRINT. 
000600 
000700 DATA DIVISION. 
FILE SECTION. 
FD SYSPRINT 
LABEL RECORD IS OMITTED 
DATA RECORD IS PRINT~LINE. 
01 PRINT-LINE. 
02 LINE-FIELD PICTURE X(121). 
WORKING~STORAGE SECTION. 
01 PRINT-VALUE PICTURE X(121) 
VALUE ' PRINT LINE PRODUCED BY SAMPL 
"E CBL PROGRAM.'. 


PROCEDURE DIVISION. 
BEGIN. 
OPEN OUTPUT SYSPRINT. 
WRITE PRINT-LINE FROM PRINT-VALUE. 
CLOSE SYSPRINT. 
STOP RUN. 
BEER JEG BRE HHEEEHEHHEHEHEHEEEEI BOTTOM OF DATA 269696369696369696 969696969636 96 96961 IEIE IE IEEE 


EDIT ~ REPLACE MENU --------~ ween ween ee nnn een ~--- 
"CURRENT" FILE: SPFDEMO.XXX.COBOL(CBLCODE1 } 


ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT = 
LIBRARY 
TYPE 
MEMBER 


SPFDEMO 
XXX 
COBOL 


mtg a 
aHuaay 
VVvVV Vv 


CMS FILE: FOR NEW CMS FILE: 
FILE ID ===> NEWFILE COBOL Al_ RECFM 
MEMBER ===> LRECL 
IF NOT LINKED, SPECIFY: 

ONNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


UPDATE PASSWORD ===> 


PRESS ENTER TO REPLACE 
PRESS END KEY TO CANCEL REPLACE 





Figure 39. Edit - REPLACE command example 
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Nulls Control 


The NULLS mode determines whether trailing blanks in each data 
field are written to the screen as blanks or nulls. The term "da- 
ta field” normally refers to the 72 characters of data on each 
line. Using hardware tabs, however, each line can be split into 
multiple fields (see "Tabs Definition and Control"). 


NULLS mode may be turned on or off by using the NULLS command. 
Format: 


NULLS [ON/OFF] [ALLI 





| Command abbreviation: NULL 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The ALL operand is valid only when NULLS mode is turned on. If 
ALL is typed, it causes all trailing blanks to be replaced with 
nulls and all-blank fields to be replaced with all-nulls. If ALL 
is omitted, one trailing blank is preserved (followed by nulls) 
and all-blank fields continue to contain blanks. 


Blank characters (hexadecimal "40') and null characters 
Chexadecimal '00°) both display as blanks. The reason for trail- 
ing nulls is to simplify use of the INSERT key on the IBM 3270 
keyboard. This key may be used to insert characters on a line, 
providing the line contains trailing nulls. In addition to using 
the NULLS command, the. user may create nulls at the end of a line 
via the ERASE EOF or DELETE key. Null characters are never stored 
in the data; they are always translated back to blanks. 


Tabs Definition and Control 
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Three types of tabs are available: "software”"™ tabs, "hardware" 
tabs, and “logical™ tabs. 


“Software” tabs are used by edit to reposition the cursor. When- 
ever the cursor is in the data portion of a line and the ENTER key 
is pressed, the cursor is moved to the next software tab position 
Cproviding software tabs have been defined). 


"Hardware" tabs allow the use of the TAB FORWARD and TAB BACKWARD 
keys to move the cursor to user-defined column positions within 
the data. This is accomplished by inserting additional attribute 
bytes in each 72~-character data area, which splits the data area 
into multiple fields. When the TAB FORWARD or TAB BACKWARD key is 
pressed, the cursor is moved to the screen position immediately 
following the next or previous attribute byte. There are always a 
least two attribute bytes on each edit line; one at the beginning 
of the line number field, and one at the beginning of the data. 


The advantage of hardware tabs is that no program interrupt is 

generated when the TAB FORWARD and TAB BACKWARD keys are pressed. 

The disadvantage is that each attribute byte occupies a screen 

a and may not be overtyped. The attribute bytes display as 
anks. 


"Logical™ tabs are used by edit to break up strings of data 
entered on a line and reposition the strings to user-defined tab 
positions. The beginning of each string is indicated by a 
user-designated special character. 


Note: Tabs are not functional when using the text entry (TE) line 
command. 
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Use of tabs is controlled by two commands: The tabs line command 
which defines tab positions, and the TABS primary command which is 
used to turn TABS mode on and off. 


Tabs Line Command 


The tabs line command is used to define tab positions for all 
three types of tabs. To display the tab definition line, the 
characters "TABS" or "TAB" are entered in the line command area, 
overtyping the line numbers. When the ENTER key is pressed, the 
tab definition line is inserted at the designated position. 


TABS - Display tab definition line 


Command abbreviation: TAB 





Software tab positions are defined by typing an underscore (_) or 
hyphen (-) at each desired column position on the tab definition 
line. Two or more consecutive underscores or hyphens may be typed 
to define a software tab field, which causes the cursor to be 
repositioned to the first non-blank character within the field. 
If the tab field contains all blanks, the cursor is positioned at 
the beginning of the field. 


Hardware and logical tab positions are defined by typing an aster- 
isk (%) at each desired column position on the tab definition 
line. The aterisks indicate the locations where the attribute 
bytes will be inserted (for hardware tabs) or the locations fol- 
lowing which strings will be repositioned (for logical tabs). 


Initially, the tab definition line contains all blanks. If the 
user displays the tab line and enters software tab definitions, 
they take effect immediately; each line contains a software tab or 
tab field at the designated column positions. Hardware and log~- 
ical tab definitions do not take effect immediately. The aster- 
isks define the column positions, but the insertion of attribute 
bytes Chardware tabs) or the repositioning of data strings Clog- 
ical tabs) does not occur unless TABS mode is ON. The user may 
enter or leave TABS mode via the TABS ON/OFF primary command. 


Figure 40 shows an example of the tab definition line displayed 
together with the column identification line. The tab Line shows 
a software tab field extending from columns 2 through 39, and a 
hardware/logical tab definition at column 43. 


The tab definition line may be removed from display by entering a 
YD" in the line command area, or by entering a RESET primary com- 
mand. The tab definition line is never saved as part of the data. 


The tab definitions remain in effect Ceven if not displayed) until 
they are again changed by the user. Tab definitions are retained 
in the current edit profile, and automatically used the next time 
the user edits the same type of data. 
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EDIT --- SPFDEMO.SAMPLE.PLICBROPDS?) - O01. 02 
COMMAND INPUT ===> 


001400 
001500 
001600 
001700 


IF BROSMEMB(1} -= 
DO: 
ZINCLUDE SYSLIB( BROFINOM}3 
IF BRORCODE = 0 THEN 


* " THEN 


7% 
“% 
7% 


COLUMNS 001 072 
SCROLL ===> HALF 
IF MEMBER SELECTED, 


FIND MEMBER 


*/ 
*/ 
*¢ 


(* IF NO ERRORS, */ 
=COLS> ie PU Pc SSE Oa aa a 
=TABS> - 

001800 "ef 
001900 INCLUDE SYSLIB(BROPDSH ) 3/* SET UP PDS HEADER ¥*/ 
002000 CALL CBRO (TLD, TDC); ha CALL COMMON BRONSE */ 
002100 END 3 7% %/f 
002200 ELSE 7*® ELSE, */ 
002300 DO; 7% */ 
602400 BROMLIST f¥% TURN OFF LIST FLAG */ 
002500 BROSMEMB. $ 7% CLEAR SEL. MEMBER */ 
002600 END; 4% %/ 
002700 END + /* */ 
002800 ELSE /* ELSE €NOTHING SELECTED } 27? 
002900 BROMLIST = OFF; é* TURN OFF LIST FLAG 

003000 END; #¥% END OF LOOP 

003100 BROSMEMB = BLANKS; 7% CLEAR SELECTED MEMBER 

003200 END; 7% 

FRI IN IEICE EER IED IEIE DE IESEIE IEEE BOTTOM OF DATA 263096363696363626969696 969696 96 EEE EE EEE IEEE IEE 





Figure 40. Edit - tab definition line 


TABS Primary Command 


TABS mode may be turned on or off by using the TABS primary 


command. Format: 


Ctab-character] [ALL] 


TAB 


TABS [ON/OFF] 


Command abbreviation: 





The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The "tab-character™ and "ALL" oper- 
ands are valid only when TABS mode is turned on. 


The "tab-character™ operand consists of a single, non-alphameric 
special) character. It defines the character to ba interpreted 
as a logical tab when encountered on input. Example: 
TABS ON $ 
If the user then enters the following information on a line: 
SaaaaaSbbb$ccce 
the data “aaaaa™ will be repositioned after the first tab column 
(as defined by an "*" jn the tab definition lined, tha "bbb" will 
be repositioned after the next tab column, etc., as follows: 


TABS x x % 


aaaaa bbb cece 
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If the "tab-character™ operand is not typed when TABS mode is 
turned on, hardware tabs are initiated by inserting attribute 
bytes at each tab position defined by an ™*" jin the tabs defi- 
nition line. If the ALL operand is coded, an attribute byte is 
inserted at all user-defined positions on each line, overlaying 
any characters in those positions. If the ALL operand is omitted, 
an attribute byte is inserted at each user-defined position on 
each line only if that character position currently contains a 
blank or null. 


Overlaying of characters with attribute bytes applies to the 
screen contents only; the attribute bytes are never recorded in 
the data. When TABS mode is turned off, the attribute bytes are 
Sp and the overlaid character at each tab position is redis- 
played. 


In TABS mode, the user may temporarily cause the attribute bytes 
to be removed on a single line by blanking out the entire line 
command field or by placing the cursor directly under one of the 
attribute bytes and pressing the ENTER key. When the ENTER key is 
pressed again, the attribute bytes will be reinserted. 


Profile Display and Control 


The current edit profile may be displayed at any time by means of 
the PROFILE primary command. This command may also be used to 
define a new profile or switch to a different profile. Format: 


PROFILE [name] [number] 





Command abbreviations: PROF, PRO 


Both operands are optional, and may be coded in either order. The 
"name" operand consists of up to eight alphameric characters, the 
first of which must be alphabetic. The "number" operand consists 
of a single digit in the range 0 to 7, inclusive. 


If neither operand is typed, the contents of the profile are dis- 
played in the data area of the screen (Figure 41). The first 
three lines show the current mode settings. The remaining lines 
show the current contents of the MASK, TABS, and BOUNDS lines, 
together with the COLS positioning line. The MASK and TABS lines 
are not displayed if they contain all blanks, and the BOUNDS line 
is not displayed if it contains the default boundary positions. 


If the "name”™ operand is typed, and if the user already has a pro- 
file of that name, edit immediately switches to the specified pro- 
file and displays it. (Display of the profile may be avoided by 
typing a zero for the "number" operand. See below.) If a profile 
of the specified name does not already exist, a new profile is 
defined with that name. The initial content of the new profile is 
the same at the profile which was in effect when the PROFILE com~ 
mand was entered. 


The "number" operand controls the number of lines shown in the 
profile display. If the number 0 is typed, it prevents display of 
the profile. If the number 7 is typed, it forces display of all 
lines, even if the MASK and TABS are blanks and BOUNDS contains 
the defaults. 


Use of profiles may also be controlled from the edit file menu. If 
the profile name field is left blank, the profile name defaults to 
the data “type” (SPF library type or CMS filetype). If a name is 
entered, it overrides the "type" qualifier. In either case, ifa 
profile of that name currently exists, it is used. If it does not 
exist, a new profile is defined. The initial content of the new 
profile has the default mode settings (see "Edit Modes and Pro- 
files"), all-blank MASK and TABS, and default BOUNDS. 
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EDIT --- SPFDEMG.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
HEHE IEE SESE REDE IE EIEN IEE IEEE EMIEIEN TOP OF DATA exe EHIME IIE IE IE HEHEHE IM 
=PROF> ....PLI (FIXED - 803....RECOVERY OFF....NUMBER ON STD... . ewer ececcnce 
=PROF> ....CAPS ON....HEX OFF....NULLS OFF... TABS OFF... cc eee cece cee cccnee 
=PROF> ....AUTONUM ON....PRINT OFF... STATS ON... ccc cece ecw e cece cccreceeeeveves 
600700 “INCLUDE SYSLIB(BROLISTN); /* LIST MEMBER NAMES */ 
000800 END; 7% x7 
000900 ELSE /* ELSE, */ 
001000 DO; 7% */ 
001100 BROMLIST = OFF; 7% TURN OFF LIST FLAG %/ 
001206 BROSMEMB = BROMMEMB; /* MOVE MEMBER NAME TO */ 
001300 END; ‘SELECTED' MEMBER ¥%7 
001400 IF BROSMEMB(1) -= ‘ * THEN IF MEMBER SELECTED, */ 
001500 DO; */7 
001600 ZINCLUDE SYSLIB(BROFINOM ); FIND MEMBER */ 
001700 IF BRORCODE = 0 THEN IF NO ERRORS, %/ 
001800 DO} 7% */ 
001900 “INCLUDE SYSLIB(BROPDSH } 5 /* SET UP PDS HEADER ¥*/ 
002000 CALL CBRO (TLD,TOC); 7 CALL COMMON BROWSE ¥*/ 
002100 END}; 7* */ 
002200 ELSE 7% ELSE,» */ 
002300 DO; . F% */ 
002400 BROMLIST / TURN OFF LIST FLAG */ 
002500 BROSMENB CLEAR SEL. MEMBER ¥*/ 
002600 END 3 %/7 
002700 END; %/ 
002800 ELSE ELSE (NOTHING SELECTED) ,*/ 





Figure 41. Edit - profile display 


90 SPF/CMS PROGRAM REFERENCE MANUAL 


Hexadecimal Display 


When edit is operating in HEX mode, three lines are displayed for 
each source line. The first line shows the data in standard char- 
acter form. The following two lines show the same data in 
hexadecimal representation. See Figure 42. 


Any invalid Cnon-displayable) characters may be changed by over- 
typing the hexadecimal representations. Any valid character may 
be changed by overtyping either the standard character represent~ 
ations or the hexadecimal representations. 


Note: The FIND and CHANGE commands may also be used to find and 
change invalid characters or any specific hex character, regard- 
less of the setting of HEX mode. See discussion of picture 
strings and hex strings under FIND and CHANGE commands. 


HEX mode may be turned on or off by using the HEX command. Format: 
HEX CON/OFF] CUVERT/DATAI 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The VERT (vertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically Ctwo rows per byte) under each character. 
DATA causes the hexadecimal representations to be displayed as a 
string of hex characters (two per byte), as shown in Figure 42. 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) ~ 01.02 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
000700 ZINCLUDE SYSLIB(BROLISTM) >; 7* LIST MEMBER NAMES */ 
40404040404040404040406CC9D5C 3D ZES4C4C540E2ESE2D3C9C24DC2D 9D6ED3C9E2E3D45D 
5E4040406 1504040404040D3C 9E2E34004C504C2C5D 940D5C 104C5E240404040405C6140 
000800 ; 7% */ 
$0404040404040404005D5C45E4040404040404040404040404040404040404040404040 
404040406 1504040404604.04.04040404040404040404040404040404040404040405C6140 


600900 7* ELSE, 
40404040404040C5D3E2C540404040404040404040404040404040404040404040404040 
404040406 15C404040C503E2C56B404040404040404040404040404040404040405C6140 

001000 a" */ 
40404040404040404004D65E404040406040604040404000404040404000404080404060 
404040406 1504040404040404040404040404040404040404040404040404040405C6140 


001100 BROMLIST = OFF; TURN OFF LIST FLAG */ 
4$0404040404040404060460C2D 9D6D4D3C 9E2E 340 7E40D6C6C65E40404040404040404046 
404040406 15C4040404040E3E4D9D540D6C6C640D3C 9E2E340C6D3C1C7404040405C6140 


(ee Wow tee fee ee ey Ney One Woe nee Das See NY TED ey ND Om Gey Com Gene Les Nene Wher Ley TANG UEP SY NEW Gey Gre Siew Wwe te leur NOP fue Ser WUD Goer ‘eww hen fem tn nat Ce Or GY OEY hee Sey SED MoU Ore Cas Sete MeN fans Gane Smee Sew Ge Sun Su TRE Gm SOY OEE Ne Sey nee Mew UR We SEND tor tone Stee See 


001200 BROSMEMB = BROMMEMB; MOVE MEMBER NAME TO ¥/ 
4040404040404040404040C2D 9N6E2D4C504C240 7E40C 2D 9D6D0404C504C25E4040404040 
404040406 15C4040404040D04D6E5C540D46C504C2C5D 940D5C 1D4C540E 3064040405C6140 

001300 3 "SELECTED' MEMBER 
404040404040404040C5D5C45E4040404040404040404040404040404040404040404040 





Figure 42. Edit ~ hexadecimal display, data 
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TEXT PREPARATION FEATURES 


The following commands are described in the section: 
Primary command: CAPS 


Line commands: TE Ctext entry) 
TS Ctext split) 
TF Ctext flow) 
0 Coverlay) 


Character Translation 


If CAPS mode is in on, alphabetic data entered at the terminal is 
automatically translated to upper case during edit operations. 
If CAPS mode is off, alphabetic data is left "as is". CAPS mode 
is normally on except when documentation (text) is being edited. 


CAPS mode also determines whether character strings, entered as 
operands of the FIND and CHANGE commands, are translated to upper 
case. Note that the keyword operands and all menu parameters are 
a ae ee to upper case regardless of the current setting 
o mode. 


CAPS mode may be turned on or off by using the CAPS command. 
Format: 


CAPS [ON/OFF] - 


If the operand is omitted, ON is the default. 


Whenever data is fetched for editing, SPF will initialize the set~- 
ting of CAPS mode based on whether the data does or does not con- 
tain lower case alphabetics. If the initial setting of CAPS mode 
differs from the previous setting in the profile, a message will 
be displayed indicating that edit has changed the mode. For new 
files or members, the initial setting of CAPS mode is unchanged 
from whatever is in the profile. The default for a new profile is 
CAPS mode ON. 


Text Entry and Edit 


All of the edit line and primary commands may be used when enter- 
ing and editing text information. Three additional line commands 
are provided specifically for this purpose: 


TE - Text Entry 
TS - Text Split 
TF ~- Text Flow 


These commands are described in the following sections. 
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Text Entry 


The text entry command is intended for bulk entry of text using 
power typing techniques. When the characters "TE" are entered in 
a line command area, blank lines are inserted starting with the 
line following the "TE". A number may follow the "TE" to indicate 
the number of blank lines to be inserted. If the number is omit~ 
ted, sufficient blank lines are inserted to fill the screen from 
the line following the "TE" to the end of the screen. 


TE ~ Text entry Cto end of screen) 
TEn - Text antry "n" lines 


The user may type information on the blank lines without regard to 
line end. The line command area on the blank lines is protected, 
and automatic cursor skip is provided from the end of one line to 
the first data position on the next line. When the ENTER key is 
pressed, the new information is automatically reflowed to fit 
within the currently defined boundaries (see BOUNDS line 
command), and any unused blank lines at the end of the new text 
are deleted. 


If insufficient blank lines have been generated, the keyboard 
will lock when the user attempts to type beyond the last character 
position of the last blank line. A vertical bar (|) will be dis- 
played above the cursor at the locked position. To generate more 
blank Lines, press the RESET key to unlock the keyboard and then 
press the ENTER key. 


Multiple paragraphs may be entered by using either of the follow- 
ing techniques: 


e leave a blank line between paragraphs, or 
° indent the start of a new paragraph with three or more blank 
(space) characters. 


Note: Tab definitions are not functional during text entry. 


Text Split 
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The text split command is intended for insertion of new material 
into existing text. To split a line, enter the characters "TS" in 
a line command area and then move the cursor to the desired split 
point Con the same line) before pressing the ENTER key. A new 
line is inserted following the line containing the "TS", and all 
text to the right of the cursor is moved to the beginning of the 
next line €following the inserted line). <A number may follow the 
"TS" to cause additional lines to be inserted. 





Figure 43 shows a before-and-after example of line splitting, 
where "TS3" was entered on line 69 and the cursor was positioned 
following the word "text" 


Automatic cursor skip is not provided from the end of one line to 
the next when the "TS" command is used. The line command areas on 
the new Lline(€s) are unprotected and may be used to enter line 
commands, as usual. 
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EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000056 
000057 
000058 
000059 
TS3 

000061 
600062 
000063 
000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 
000078 
000079 
000080 
000081 


sH6.TEXT SPLIT 


THE TEXT SPLIT COMMAND IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 
EXISTING TEXT. _TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 
COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 
SAME LINE) BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 
FOLLOWING THE LINE CONTAINING THE "TS''; AND ALL TEXT TO THE RIGHT OF THE 
CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 
INSERTED LINE). A NUMBER MAY FOLLOW THE "TS" TO CAUSE ADDITIONAL LINES 
TO BE INSERTED. 


.FO OFF 
.BX 9 72 
TS - TEXT SPLIT AND INSERT LINE 
TSN ~ TEXT SPLIT AND INSERT "N” LINES 
.BX OFF 
-FO ON 


:FIGREF REFID='ETS*'. SHOWS A BEFORE-AND-AFTER EXAMPLE OF LINE 
SPLITTING, WHERE "TS3" WAS ENTERED ON LINE 60 AND THE CURSOR WAS 
POSITIONED FOLLOWING THE WORD "TEXT". 


AUTOMATIC CURSOR SKIP IS :HP1.NOT:EHP1. PROVIDED FROM THE END OF ONE 
LINE TO THE NEXT WHEN THE "TS" COMMAND IS USED. THE LINE COMMAND AREAS 
ON THE NEW LINE(S) ARE UNPROTECTED AND MAY BE USED TO ENTER LINE 


EDIT --- SPFDEMO SCRIPT Cl ------ eee eee eee nnn ee wee eeee ~--- COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000056 
000057 
000958 
000059 
000060 


000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 
000078 
000079 
000080 
000077 


3H6.TEXT SPLIT 


THE TEXT SPLIT COMMAND IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 
EXISTING TEXT. 


TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 

COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 
SAME LINE) BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 
FOLLOWING THE LINE CONTAINING THE "TS", AND ALL TEXT TO THE RIGHT OF THE 
CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 
INSERTED LINE). A NUMBER MAY FOLLOW THE "TS" TO CAUSE ADDITIONAL LINES 
TO BE INSERTED. 


-FO OFF 
BX 9 72 
TS = TEXT SPLIT AND INSERT LINE 
TSN - TEXT SPLIT AND INSERT "N" LINES 
«BX OFF 
-FO ON 


:FIGREF REFID="ETS'. SHOWS A BEFORE-AND-AFTER EXAMPLE OF LINE 
SPLITTING, WHERE "TS3" WAS ENTERED ON LINE 60 AND THE CURSOR WAS 
POSITIONED FOLLOWING THE WORD “TEXT". 





Figure 43. Edit ~- text split example 


BSS 
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The text split command may also be used in conjunction with other 
line commands to move or copy text. Use "TS" at the end points of 
the material to be moved or copied Ci.e., to break it out so that 
is is wholly contained on one or more lines). In addition, use 
"TS" at the insertion point to open up space. Then use the stand- 
ard move ("M" or "MM") or copy C"™C"™ or "CC") Line command together 
with the after ("A") or before ("B") line command. 


Figure 44 shows an example of a sentence to be moved from one par- 
agraph to another. In the first part of the figure, the sentence 
on lines 33-35 has already been split out by using the "TS" com- 
mand twice Conce with the cursor at the beginning of the sentence, 
and again at the end of the sentence). Another "TS" command is 
now entered on line 44 to split the second paragraph at the desti~- 
nation point for the move. The second part of the figure shons 
the use of "MM" and "A® to accomplish the move. 
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EDIT --~ SPFDEMO SCRIPT Cl ~ COLUMNS 001 072 

COMMAND INPUT ===> | SCROLL ===> HALF 

000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 

000032 END. 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 

000035 DATA POSITION ON THE NEXT LINE. 

eueaees 

000037 WHEN THE ENTER KEY IS PRESSED, THE NEW 

000038 INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 

000039 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 

000040 AT THE END OF THE NEW TEXT ARE DELETED. 

000041 

000042 IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. _A VERTICAL BAR ({) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


sUL 
:LI.LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 
sLI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 
CHARACTERS. 
000055 ;sEUL 


EDIT --~ SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
000030 
000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
END. 
THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 
AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
DATA POSITION ON THE NEXT LINE. 
WHEN THE ENTER KEY IS PRESSED, THE NEW 
INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. 


A VERTICAL BAR (1) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY.» 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


:UL 

s:LI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

:LI.INDENT THE START OF A NEN PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 
000055 CHARACTERS. 





Figure 44. Edit - move santence example 


EDIT COPTION 2) 97 


Text Flow 


The text flow command may be used to reflow paragraphs following 
deletions, insertions, splitting, etc. When the characters "TF" 
are entered in a line command area, the text is reflowed from the 
beginning of that line to the end of the paragraph. 


TF ~ Text flow Cbetween current bounds) 
TEn ~- Text flow from Left bound to column "n" 


The terion operation will remove trailing blanks on a line by 
pulling in material from the following line. It will not, howev- 
er, remove embedded blanks within a line. Accordingly, if one or 
more words in a line are to be deleted, the 3270 DELETE key should 
be used Crather than overtyping the words with blanks). 


The text to be flowed is taken from within the currently defined 
column boundaries (€see BOUNDS line command). Any text outside the 
bounds does not participate in the flow operation. The reflowed 
text is also positioned within the current bounds. If the ori- 
ginal text was indented from the left boundary, the indentation is 
preserved. 


Each line of the reflowed text normally extends to the right 
boundary position. However, the text may be "squeezed up” by 
entering a number after the "TF" command. The number specifies 
the right-most column postion for the reflowed text. It must be 
less suse the current setting of the right bound Cotherwise, it is 
ignored). 


A before and after example of text flow is shown in Figure 45. 
The bounds are set at 1 and 72. A "TF50" command is entered on 
line 41. All text between 1 and 72 participates in the flow, but 
the results are contained within columns 1 and 50 


Use of Program Function Keys for Text Commands 
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Whenever heavy use is being made of the text Line commands, it is 
strongly recommended that both the text split and text flow com- 
mands be assigned to program function (PF) keys. For users of 
l2-key terminals, infrequently used PF keys such as Shift Right 
and Shift Left may be reassigned to these functions. Use SPF 
Parms Coption 0.3) to reassign the keys. Example: 


PF10 = 
PF11 = 


With these key definitions, a text split may be accomplished by 
moving the cursor to the desired split point (within a Line) and 
pressing PF10. After the new material has been typed, PF11 may be 
pressed to reflow the text from the line containing the cursor to 
the end of the paragraph. 


SPF/CMS PROGRAM REFERENCE MANUAL 


EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000030 
000031 
000032 
000033 
000034 
000035 
000036 
000037 
000038 
000039 


000055 


THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
END. 

THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
DATA POSITION ON THE NEXT LINE. 

WHEN THE ENTER KEY IS PRESSED, THE NEW 

INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. A VERTICAL BAR (|) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


UL 

:LI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

:LI.JINDENT THE START OF A NEN PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 
CHARACTERS. 

sEUL 


EDIT --~ SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000030 
000031 
900032 
000033 
000034 
000035 
000036 
000037 
000038 
000039 
000040 
000041 
000042 
000043 
000044 
000045 
000046 
000047 
000048 
000049 
000050 
000051 
000052 
000053 
000054 
000055 


Figure 


THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
END. ; 

THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
DATA POSITION ON THE NEXT LINE. 

WHEN THE ENTER KEY IS PRESSED, THE NEN 

INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, 
THE KEYBOARD WILL LOCK WHEN THE USER ATTEMPTS TO 
TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. A VERTICAL BAR (|) WILL BE 
DISPLAYED ABOVE THE CURSOR AT THE LOCKED POSITION. 
TO GENERATE MORE BLANK LINES, PRESS THE RESET KEY 
TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER 
KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


:UL 
:LI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 
:LI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 





45. Edit - text flow example 
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Qverlaying Lines 
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The overlay Line ("07 or "00") command allows a list of items to 
be rearranged in multi-column (tabular) format. The overlay com- 
mand may be used with the move line ("™M" or "MM™) or copy line 
cVPc" or "CC™) Line commands. It is used in place of the after 
CVA") command. 


The character "0" may be entered in a line command area to speci fy 
the line over which data is to be moved or copied. A number may 
follow the "0" to indicate the number of lines to be overlayed. A 
block of lines to be overlayed may be specified by entering "00" 
on the first and last lines of the block. 


0 - Overlay line 


On -~- Overlay "n" lines 
00 - Overlay block of lines 





Blank characters in the receiving line(s), specified with "0" or 
"900", are overlayed with corresponding characters from the source 
line(€s), specified with "M"™, "MM", "C"™, or FCC". Non-blank char~ 
acters are not overlayed. 


Only those characters which are within the current column bounda~ 
ries participate in the overlay operation (see description of 
BOUNDS command). 


The number of source and receiving lines need not be the same. If 
there are more receiving lines, the source lines are repeated 
until the receiving lines are used up. If there are more source 
lines, the extra source lines are ignored. 


Only data lines participate in the overlay operation. Special 
lines such as MASK, TABS, BOUNDS, and COLS are ignored as either 
source or receiving lines. 


A before and after example of overlaying lines is shown in 
Figure 46. Generally, a list such as that shown in the figure 
would be maintained and edited as a single column Cleft adjusted). 
Prior to the overlay, portions of the list would be right-shi fted 
by the appropriate amounts to overlay in the multi-column format. 
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EDIT ~-- SPFDEVEL.PRM.SCRIPT(DEMO) ~- 01.00 ---------- Se ety Ss COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


GENERAL COMMANDS: 


coLs 

I, IN CINSERT) 
BD, DN, (DELETE) 
R» RN» (REPEAT) 
M> MN» (MOVE) 
C, CN, (COPY } 

A (AFTER) 
B (BEFORE )- 


ADVANCED FEATURES: 


MASK 

<y <Ny <<, <<N (DATA LEFT) 

>» Ny» >>, >>N (DATA RIGHT) 

(> (Ns (0, CON (COLUMNS LEFT) 
Y» JN» 3s JIN (COLUMNS RIGHT) 
BOUNDS 


MM. 
JOBE JERE BHOREURBHUOBOROEGEE BOTTOM OF DATA 2008 HORR ERROR EEIOIEEIEIEIIEE 


EDIT --- SPFDEVEL.PRM.SCRIPT(DEMO) ~ 01.00 --9--------------- COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 
000035 

900036 GENERAL COMMANDS: ADVANCED FEATURES: 

000037 

000038 coLS MASK 

000039 I, IN (INSERT) <y <N» <<, <<N (DATA LEFT) 
000040 D, DN» (DELETE } >» Ne >>, >>N (DATA RIGHT) 
000041 R» RN» (REPEAT } (> (Ny (0, CON CCOLUMNS LEFT) 
000042 M> MN; (MOVE ) ¥» IN,» 33, JIN (COLUMNS RIGHT) 
000043 C> CN» (COPY) BOUNDS 

000044 A (AFTER } 

000045 B (BEFORE ) 

000046 

HHI IE IIE IE HIE NEHER HEINE BOTTOM OF DATA 2963626269696 96 6262696696 9 IEE DE FE IEE IE FE ESE EERE DE 





Figure 46. Edit - overlay line example 
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UTILITIES COPTION 3) 


The utility option provides a variety of functions for: SPF 
library and file maintenance, moving and copying data, printing 
or displaying SPF project listings, resetting SPF library statis- 
tics, initiating spool output, retrieving data from the virtual 
reader, retrieving SPF libraries (via tape) from a TS0 system, and 
formatting SCRIPT/VS documentation. 


When the utility option is selected (primary option 3), a second- 
ary selection menu is displayed (Figure 47). It is possible to 
bypass the secondary menu by entering two numbers, separated with 
a decimal point, on the primary option menu. For example, enter- 
ing "3.2" on the primary menu has the same effect as entering "3" 
on the primary menu and "2" on the secondary menu. 


SELECT OPTION ===> _ 
1 LIBRARY - LIBRARY UTILITIES: 
PRINT INDEX LISTING OR ENTIRE FILE 
PRINT, RENAME, DELETE, OR BROWSE MEMBERS 
COMPRESS SPF LIGRARY OR CMS MACLIB 
FILE UTILITIES: 
SPECIFY OR UNSPECIFY SPF LIBRARY 
DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 
RENAME OR DELETE SPF LIBRARY OR CMS FILE 
MOVE/COPY ~ MOVE OR COPY MEMBERS OR FILES 
PROJECT PRINT OR DISPLAY SPF PROJECT LIBRARIES 
RESET RESET STATISTICS FOR MEMBERS OF SPF LIBRARY 
SPOOL INITIATE SPOOL OUTPUT 
READER RETRIEVE BATCH OUTPUT FROM READER 
RETRIEVE RETRIEVE SPF/TSO LIBRARIES FROM TAPE 
SCRIPT FORMAT, DISPLAY, AND OPTIONALLY PRINT SCRIPT TEXT 





Figure 47. Utility selection menu 


The following describes each of the utility functions, corre- 
sponding to each option on the secondary menu: 
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LIBRARY UTILITY COPTION 3.1) 


When this option is selected Cutility option 1), a menu is dis- 
played which allows the user to specify a file and indicate an 
action to be performed (Figure 48). Possible actions are: 


Compress SPF library or CMS MACLIB 
Print index listing 
Print SPF library or CMS file 
Print member 
Rename member 
Delete member 
~- Browse member 
lank - Display member list 


oO 


X 
L 
P 
R 
D 
B 
b 


Note: The library utility is intended primarily for maintenance 
of SPF libraries, MACLIBs, and TXTLIBs, but the "Yorint index List- 
ing™ and “print SPF library or CMS file” functions also apply to 
sequential CMS files. 


LIBRARY UTILITY 


C ~ COMPRESS SPF LIBRARY OR CMS MACLIB PRINT MEMBER 

X =~ PRINT INDEX LISTING RENAME MEMBER 
L - PRINT SPF LIBRARY OR CMS FILE DELETE MEMBER 
BLANK ~- DISPLAY MEMBER LIST BROWSE MEMBER 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 
NEWNAME 


SPFDEMO 

XXX 

COBOL 
CIF OPTION "P™, "R's "D's OR "B" SELECTED) 
(IF OPTION "R" SELECTED} 


“oan ao tt 
ie ud tm a tf 
“loan i 


VvVVVY 


CMS FILE: 
FILE ID 
MEMBER 
NERWNAME 
IF NOT L 
OWNER'S I 


(IF OPTION "P", "R™, "D'", OR "B'" SELECTED) 
(IF OPTION "R" SELECTED) 
» SPECIFY: 
=? DEVICE ADDR. ===> LINK ACCESS MODE ===> 


eqnou ou 


i~] OZ uu 
Aa ot 
amvyvv 


D 


READ PASSWOR 


UPDATE PASSWORD ===> 





Figure 48. Library utility menu 


If option "C" (compress SPF library or CMS MACLIB) is selected, 
any MACLIB Cincluding an SPF library with a MACLIB organization) 
may be specified. The compress is accomplished by invoking the 
MACLIB command. 


If option "X" (print index listing) is selected, any SPF library 
or CMS file may be specified. The index listing is recorded in 
the SPF list file. For SPF libraries, MACLIB's, and TXTLIBs, the 
index listing includes general information about the library fol- 
lowed by a member list. For a sequential CMS file, the index 
listing includes general information only. See Appendix C for an 
example of index Listing format. 
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If option "L" Cprint SPF library or CMS file) is selected, any SPF 
library or CMS file may be specified. A source listing of the 
entire file Cincluding all members), praceded by an index list- 


ing, is recorded in the SPF list file. 


If option "P" (print member) is selected, a member of any SPF 
library, MACLIB, or TXTLIB may be specified. A source listing of 
the member is recorded in the SPF list file. 


If option "R" or option "D" Crename member or delete member) is 
selected, a member of any SPF library, MACLIB, or TXTLIB may be 
specified. A new member name must also be specified for the "re~ 
name member" function. 


If option "B" Cbrowse member) is selected, a member of any SPF 
library, MACLIB, or TXTLIB may be specified. The specified member 
Will be displayed in browse mode. All browse commands can be exe- 
cuted. When browse is terminated by pressing the End PF key, the > 
menu from which the member was selected will be redisplayed. 


If no option is specified (blank to display member listing), any 
SPF Library, MACLIB, or TXTLIB may be specified. A member listing 
is then displayed from which the user may select members for 
printing, renaming, deleting, or browsing by entering "P", "R", 
"D", or "B" respectively in front of one or more member names. For 
renaming, 8 new member name must also be entered in the field 
immediately following the current member name. 


The member list may be scrolled up and down via the scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
pressing the End PF key, which causes a return to the previous 
menu. 


Figure 493 shows a before-and-after example where members ACCTI 
and ACCT2 are printed, member UPDATE is deleted, and member 
LISTNEW is renamed LISTOUT. 
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UTILITIES --- SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> 
RENAME VER.MOD CREATED 


NAME 
ACCOUNT 
ACCT 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 


LISTNEW LISTOUT 


MAIN 

TESTDIR 
D UPDATE 

XX END HH% 


61.00 
01.01 
01.00 
01.04 
01.00 
01.01 
61.00 
01.02 
61.00 
01.02 
01.00 


79/01/09 
79701709 
79701709 
79704724 
79/01/09 
79701714 
79704723 
79704723 
79/01/09 
79/04/23 
79/01/09 


UTILITIES --- SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> _ 
RENAME VER.MOD CREATED 


NAME 
ACCOUNT 
ACCTI 
AcCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 
XX END HH 


Figure 49. Library utility - print, rename, and delete 


*PRINTED 
*PRINTED 


*RENAMED 


*DELETED 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
61.00 
01.02 
01.00 
01.04 
01.00 


79/01/09 
79701709 
79/01/09 
79704724 
79/01/09 
79/01714 
79/04/23 
79/04/23 
79/01/09 
79704723 
79/01/09 


LAST MODIFIED 


79701709 
79/04/23 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79704/23 
79/04/23 
79701709 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


LAST MODIFIED 


79/01/09 
79/04/23 
79701709 
79704724 
79/01/09 
79/01714 
79/04/23 
79/04/23 
79701709 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 
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SCROLL 
MOD 


INIT 
21 
193 
20 
19 
G4 
13 
20 
13 
4 
43 
13 


= 
eceocarwr otk ooed 


i+] 


===> PAGE 


MOSTON 
KLEIN 

MOSTON 
MOSTON 
MOSTON 


SCROLL ===> PAGE 
MOD 


‘a 
ecoetorokooe 
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FILE UTILITY COPTION 3.2) 


When this option is selected Cutility option 2), a menu is dis~- 
played which allows the user to specify a file and indicate an 
action to be performed (Figure 50). Possible actions are: 


S$ - Specify new SPF Library 
U - Unspecify an SPF library 


R Rename file or SPF library 
DB - Delete ("erase") file or SPF library 
blank - Display file or SPF library information 


For options "S" and "U", an SPF library identification (project, 
library, and type) must be specified. For the other options, any 
SPF library or CMS file may be specified. 


SELECT OPTION ===> 


$ ~ SPECIFY NEW SPF LIBRARY 

U ~ UNSPECIFY AN SPF LIBRARY 

R ~ RENAME SPF LIBRARY OR CMS FILE 

D - DELETE SPF LIBRARY OR CMS FILE 

BLANK ~- DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 


SPF LIBRARY: 
PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 


CMS FILE; 
FILENAME ===> 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSWORD ===> 





Figure 50. File utility menu 


If option "S" (specify new SPF library) is selected, a menu is 
displayed to allow specification of SPF library attributes and 
location (minidisk), link access mode for update, and correspond- 
ing CMS filetype/filename (Figure 51). Default values are 
pre-entered based on what the user last entered, or based on the 
last "display file information" request (whichever occurred most 
recently). The user may overtype the displayed defaults. 


See Appendix B for guidelines in specifying SPF libraries. 


If option "U" Cunspecify SPF library) is selacted, a confirmation 
menu is displayed to ensure that the user did not select this 
option by mistake. As directed in the menu, the user must then 
press either the ENTER key to confirm or the End PF key to cancel. 
Either action causes a return to the previous menu. 
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Option "U™ causes the information about the SPF library to be 
purged from the SPF catalog, but it does not cause the associated 
file(s) to be deleted. 


If option "R”™ Crename file or SPF library) is selected, a menu is 
displayed to allow the user to enter the new file or SPF library 
identification (Figure 52). The user may type the new identifi- 
er(s) and press ENTER (to rename), or press the End PF key to 
cancel. Either action causes a return to the previous menu. 


If option "D" Cdelete file or SPF library) is selected, a confir- 
mation menu is displayed to ensure that the user did not select 
this option by mistake. As directed in the menu, the user must 
then press either the ENTER key to confirm or the End PF key to 
cancel. Either action causes a return to the previous menu. 


If an SPF library is specified, option "D" causes the library to 
be unspecified and the associated file(s) to be deleted (erased). 


If no option is specified (blank to display file or SPF library 
information), the location, characteristics, and current space 
utilization of the specified library or file are displayed 
(Figure 53). The user may return to the previous menu by pressing 
either the ENTER or End PF key. 


SPECIFY NEW SPF LIBRARY 
SPF LIBRARY NAME: NEWPROJ.MASTER .ASSEMBLE 


SPF LIBRARY ATTRIBUTES: 
ORGANIZATION (S = SET OF FILES, M = MACLIB, T = TXTLIB) 
RECORD FORMAT (F = FIXED, V = VARIABLE) 
RECORD LENGTH (1 ~ 32767 BYTES) 


SPF LIBRARY LOCAT 
ORNER'S ID TEPHENS (BLANK FOR YOUR USERID) 
DEVICE ADDR. (BLANK FOR ‘191') 


LINK ACCESS MODE PDATE: 
MODE LETTERS (M, W, OR MWD) 


FOR ORGANIZATION ET OF FILES): 
FILETYPE (BLANK CAUSES SPF TO GENERATE A NAME) 


FGR ORGANIZATION T (MACLIB OR TXTLIB): 
FILENAME (BLANK CAUSES SPF TO GENERATE A NAME) 





Figure 51. File utility ~- specify new SPF library 
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ween eee ee eee ee ee eee --- RENAME SPF LIBRARY 
SPF LIBRARY NAME: SPFDEMO.XXX.COBOL 


SPF LIBRARY LOCATION: 
OWNER'S ID: SPRINGER 
DEVICE ADDR: 195 


NEW SPF LIBRARY NAME: 
PROJECT == 
LIBRARY == 
TYPE = 


Figure 52. File utility - rename SPF library 


= SPF LIBRARY INFORMATION 
SPF LIBRARY NAME: SPFDEMO.MYLIB.PLI 


SPF LIBRARY ATTRIBUTES: 
ORGANIZATION: M (S = SET OF FILES, M = MACLIB, T = TXTLIB) 
RECORD FORMAT: F (F = FIXED, V = VARIABLE) 
RECORD LENGTH: 80 


SPF LIBRARY LOCATION: 
OWNER'S ID: STEPHENS 
DEVICE ADDR: 5FE 


SPF LIBRARY ACCESSIBILITY: 
LINK ACCESS MODE FOR UPDATE: MW 


EQUIVALENT FILE DATA: 
CMS FILE ID: DEMOPLI MACLIB 


Figure 53. File utility - display information 
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MOVE/COPY UTILITY COPTION 3.3) 


When this option is selected Cutility option 3), a menu is dis- 
played which allows the user to specify the "from" file Cand mem- 
ber if it is an SPF library, MACLIB, or TXTLIB), and to indicate 
an action to be performed (Figure 54 top). Possible actions are: 


CP -=- Copy file or member(s) and print 
MP - Move file or member(s) and print 
Cc -~ Copy without printing 
M - Move without printing 


When ENTER is pressed, a second menu is displayed which allows the 
user to specify the "to" file (Figure 54 bottom). If the "to" 
file is an SPF library, MACLIB, or TXTLIB, the option to replace 
like-named members CYES or NO) must be specified. If the "to" 
file is sequential, a disposition COLD or MOD) must be specified. 
A disposition of OLD causes an existing file to be rewritten. A 
disposition of MOD causes the "from" data to be appended to the 
end of an existing "to" file. 


Any SPF library or CMS file may be specified for either the "from™ 
or "to" file, but the same SPF library, MACLIB, or TXTLIB may not 
be specified as both the "from™ and "to" file. 


If the "to" file is a CMS file which does not currently exist, a 
new file will be created with the same attributes as the "from" 
file. If the "to" file is an SPF library, it must have been pre-~- 
viously specified via option 3.2 (specify SPF library). 


If "move" is indicated and the "from" file is an SPF library, 
MACLIB, or TXTLIB, the selected member(s) will be deleted in the 
"from" file after they have been successfully copied to the "to" 
file. If "move™ is indicated and the "from" file is a sequential 
CMS file, the entire "from" file will be deleted after its con-— 
tents have been successfully copied to the "to" file. If "copy" 
is indicated, no deletions will occur. 


If "print" is indicated for either move or copy, source Llisting(s) 
will be recorded in the SPF list file. If the "to” file is an SPF 
library, MACLIB, or TXTLIB, a listing of each new or replaced mem- 
ber will be recorded. If the "to" file is a sequential CMS file, a 
listing of its entire contents will be recorded after the informa- 
tion has bean successfully copied. 


The following rules apply for specifying member names if the 
"from" file is an SPF library, MACLIB, or TXTLIB: 


° Specifying a valid "from" member name causes a single member 
to be moved or copied. 


° Leaving the "from" member name blank causes a member listing 
to be displayed (after the second menu has been displayed). 


° Specifying a "from”™ member name of asterisk (€*) causes all 
members to be moved or copied. 


If the "to" file is an SPF library, MACLIB, or TXTLIB, the "to" 
member name must be specified for the following conditions: 


e The "from”™ file is a sequential CMS file. 

® A single member is to be moved or copied and the member is to 
be renamed in the "to" file. (Members may also be renamed 
from the member listing, see below.) 


In all other cases, the "to" member should be left blank. 


UTILITIES (OPTION 3) 109 


SELECT OPTION ===> C 


CP - COPY FILE OR MEMBER(S) AND PRINT Cc - COPY WITHOUT PRINT 
MP ~- MOVE FILE OR MEMBER(S) AND PRINT M - MOVE WITHOUT PRINT 


SPECIFY "FROM FILE BELOW, THEN PRESS ENTER TO SPECIFY "TO" FILE 


FROM SPF LIBRARY: 
PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE > PLI 
MEMBER > * (BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 


FROM CMS FILE: 


MEMBER ===> (FOR MACLIB OR TXTLIB) 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSWORD ===> 


COPY --- FROM SPFDEMO.MYLIB.PLI(*) 
SPECIFY "TO" FILE BELOW 


TO SPF LIBRARY ; 
PROJECT ===> SPFDEMO 
LIBRARY ===> MASTER_ 
TYPE ==> PLI 


TO CMS FILE FOR NEW CMS FILE: 


FILE ID === 
MEMBER === 
IF NOT LINK 
OWNER'S ID 


> RECFM 

> LRECL 

ED, SPECIFY: 

===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


UPDATE PASSRORD ===> 


REPLACE LIKE-NAMED MEMBERS > YES (YES OR NO) 
"TO" CMS FILE DISPOSITION > OLD (OLD OR MOD) 





Figure 54. Move/Copy utility manus 
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A member listing is displayed when the "from" file is an SPF 
library, MACLIB, or TXTLIB, and the "from™ member name is left 
blank. The user may select members to be moved or copied by 
entering an "S" in front of one or more member names. The options 
for move or copy, and print or no print must have been previously 
specified on the first move/copy file menu. If the "to" file is 
an SPF library, MACLIB, or TXTLIB, the member(s) may also be 
renamed by entering a new member name in the field immediately 
following the current name. 


The member list may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member List may be terminated by 
pressing the End PF key, which causes a return to the first 
move/copy menu. 


Figure 55 shows a before-and-after example where members ACCOUNT, 
ACCT1, ACCT2, and COMPY are copied to another Library, and member 
COMPY is also renamed ZCOMP. 


For any move/copy operation, the following rules apply. 


° If the "to" file is sequential, its entire contents are 
replaced (if disposition OLD was specified) or the new infor- 
mation is added to the end Cif disposition MOD was specified). 
If multiple members of an SPF library, MACLIB, or TXTLIB are 
moved or copied to a sequential CMS file by using a member 
selection list or by specifying all members (%), they are 
merged in the "to" file regardless of the disposition. 


° If the "to" file is an SPF library, MACLIB, or TXTLIB, new 
members are added except when the member names are alike; 
like-named members are replaced Cif replace YES was speci- 
fied) or not copied Cif replace NO was specified). 


° Record formats and logical record lengths for the two files 
need not be alike. When necessary, data will be truncated or 
pe ueaeoss with blanks to accommodate different record 

engths. 


° The data to be moved or copied is not renumbered or modified 
in any way, except for possible truncation or padding as noted 
above. Printer control characters, if present, are treated 
as part of the data. 


° SPF library statistics are not modified when moving or copy- 
ing between SPF libraries. 
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COPY --- FROM SPFDEMO.MYLIB.PLI TO SPFDEMO.MASTER.PLI --------------------~-~ 
COMMAND INPUT === 
RENAME VER.MOD CREATED 


NAME 
ACCOUNT 
ACCT1 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTOUT 
MAIN 
TESTDIR 
¥XXEND HH 


NAME 
ACCOUNT 
ACCT] 
ACCT2 
COINS 
COMPX 
COMPY 


ZCOMP_ 


01.00 
61.01 
61.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
61.02 


79/01/09 
79701709 
79/01/09 
79/04/24 
79701709 
79701714 
79/04/23 
79/04/23 
79701709 
79/04/23 


RENAME VER.MOD CREATED 


*COPIED 
*COPIED 
*COPIED 


*COPIED 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 


79/01/69 
79701709 
79/01/09 
79/04/24 
79/01709 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79704723 
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LAST MODIFIED 


79701709 
79/04/23 
79/01/09 
79/04/24 
79/01/09 
79701714 
79/04/23 
79/04/23 
79701709 
79/05/06 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 


COPY --- FROM SPFDEMO.MYLIB.PLI TO SPFDEMO.MASTER.PLI 
COMMAND INPUT ===> _ 


LAST MODIFIED 


79/01/09 
79704723 
79701709 
79/04/24 
79/01/09 
79701714 
79704723 
79704723 
79/01/09 
79/05/06 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:09 
17:08 
17:04 


SIZE 


SCROLL 
MOD 


INIT 
21 21 
99 193 
20 
19 
44 
13 
20 
13 
4 
43 


- 


SCROLL 


Figure 55. Move/Copy utility - copy members from list 


===> PAGE 


eocoroflodco 


x 
S 


— 


eatrororoscs7ad 


IO 
KLEIN 
KLEIN 
ORR 
ORR 
ORR 
ORR 
MOSTON 
KLEIN 
MOSTON 
MOSTON 


> PAGE 
ID 
KLEIN 
KLEIN 
ORR 
ORR 
ORR 
ORR 
MOSTON 
KLEIN 
MOSTON 
MOSTON 
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When this option is selected Cutility option 4), a menu is dis- 
played that allows the user to specify parameters for an SPF 
library and an action to be performed (Figure 56). Possible 
actions are: 


P -=- Print project entries 
blank - Display project entries 


Information may be requested for: 


° All SPF libraries known to the system, by specifying an aster- 
isk (%) for the project name. 


® All SPF libraries with a given project name, by specifying the 
project name and leaving the library name blank. 


° All SPF libraries with a given project and library name. 


If option npr Cprint project entries) is selected, a project list- 
ing is recorded in the SPF list file. The listing contains CMS 
file identifications, locations, and file characteristics for 
each SPF library with the specified project name. 


If no option is specified (blank to display project entries), a 
project listing is displayed at the terminal in browse mode. The 
listing may be scrolled up and down via the Scroll PF keys. All 
browse commands may be entered. The listing may be terminated by 
pressing the End PF key, causing a return to the previous menu. 


‘Figure 57 shows an example of an SPF project listing. 


P - PRINT PROJECT ENTRIES 
BLANK - DISPLAY PROJECT ENTRIES 


SPF LIBRARY NAME: 
PROJECT ===> SPFDEVEL_ ( % FOR ALL PROJECTS) 
===> (BLANK CAUSES ALL LIBRARIES TO BE PROCESSED) 


LIBRARY 





Figure 56. SPF project utility menu 
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PROJECT LISTING FOR SPFDEVEL 


COMMAND INPUT ===> _ 


LINE 00001 COLS 001 080 


SCROLL 


> PAGE 


HRM HEHE IER HEHE HHH NH HHH HHHKKKER TOP OF DATA Hie -CAPS ON- HH 


SPF LIBRARY NANE 


SPFDEVEL..CVIOTPLS.PLI 
SPFDEVEL.CV1OTTXT. TEXT 
SPFDEVEL.G032779.MSGS 
SPFDEVEL.6033079.MSGS 
SPFDEVEL.G041279.MSGS 
SPFOEVEL.JACK.ASM 
SPFDEVEL.JACK COBOL 
SPFDEVEL. JACK. TEST 
SPFDEVEL. JACK. TEXT 
SPFDEVEL.JAS.PLI 
SPFDEVEL.KLEIN.PLT 
SPFDEVEL .MOSTON.PLI 
SPFDEVEL.MOSTON. TEXT 
SPFDEVEL.M032779.MENUS 
SPFDEVEL.M033079.NENUS 
SPFDEVEL .M041279.MENUS 
SPFDOEVEL.ORR.EXEC 
SPFDEVEL.ORR.MAC 
SPFDEVEL.P032779.PLT 
SPFDEVEL.T3IGIM. SCRIPT 
SPFDEVEL. T3IGC.SCRIPT 
SPFDEVEL.T3PLM.SCRIPT 
SPFDEVEL.T3PRM.SCRIPT 


FILENAME 


CVIOTPLI 
CVLOTTXT 
SPFO002M 
SPF0003M 
SPF0004M 


032779 
1033079 
N0G1279 


* 
ORRMAC 
SPFOOOLM 

* 


FILETYPE 


MACLIB 
TXTLIB 
MACLIB 
MACLIB 
MACLIB 
ASSEMBLE 
COBOL 
SEQ 
TEXT 

PLI 


MACLIB 
SCRIPT 
SCRIPT1I 
SCRIPT2 
SCRIPTS 


USER ID 


STEPHENS 
STEPHENS 
ORR 

ORR 

ORR 
COSTELLO 
COSTELLO 
COSTELLO 
COSTELLO 
STEPHENS 
KLEIN 
MOSTON 
MOSTON 
GRR 


ORR 
PAQUETTE 
JOSLIN 
JOSLIN 
JOSLIN 
JOSLIN 


193 
193 
191 
191 
191 
191 
191 
1i9l 
191 
191 
191 
191 
i91 
191 
191 
191 
191 
191 
191 
194 
194 
194 
194 


Figure 57. SPF project utility ~ sample listing 
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Mw 
MW 


MW 
MW 
MW 
Mw 
MW 
MA 
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MW 
MW 
MW 
MW 
MW 
MW 
MW 
MW 
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M 

M 
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RESET SPF STATISTICS UTILITY COPTION 3.5) 


When this option is specified Cutility option 5), a menu is dis~ 
played that allows the user to create, update, or delete SPF sta- 
tistics and to reset sequence numbers (Figure 58). The reset 
utility handles SPF libraries only. Refer to the section entitled 
"Library Activity Statistics” on page 15 for a discussion of the 
type of information maintained for each member of an SPF library. 


There are three valid options for this utility: 


R - Create/update statistics, conditionally reset sequence 
numbers 


N - Create/update statistics, no reset of sequence numbers 


D -~ Delete SPF statistics 


RESET SPF STATISTICS 
SELECT OPTION ===> R 


R - CREATE/UPDATE SPF STATISTICS, CONDITIONALLY RESET SEQUENCE NUMBERS 
N - CREATE/UPDATE SPF STATISTICS, NO RESET OF SEQUENCE NUMBERS 
D - DELETE SPF STATISTICS 


NEW VERSION NUMBER (REQUIRED FOR OPTION R) 
NEW CMS USER ID (IF USER ID IS TO BE CHANGED) 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 


MEMBER (BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 


UPDATE PASSKORD 





Figure 58. Reset utility menu 


The "R™ option is used to either create SPF statistics in a 
library which does not currently have them, or to update SPF sta- 
tistics in a library. The data is scanned to determine if valid, 
ascending sequence numbers are present in all records. If so, the 
data is renumbered and the modification level flags (the last two 
digits of each sequence number) are set to zeros. If valid 
sequence numbers are not present, renumbering 15 not done. 


The "N" option is also used to create or update SPF statistics, as 
in option "R"; however the data is not renumbered. This option 
should be used if the data already contains SPF statistics and the 
user wants to update the user id and/or version information with~ 
out renumbering the data. 


The "D" option is used to delete SPF statistics. 
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The version number field is required for option "R", optional for 
option "N", and ignored for option "D". If option "N" jis selected 
and a member without SPF statistics is selected, the statistics 
are created as if the version had been specified as "1". Ifa 
ere ien number is specified, the statistics are created or reset 
as follows: 


Version number: Set to the specified value 
Modification level: Set to zero 
Creation date: Set to current date 


Date/time last modified: Set to current date and time | 
Current number of lines: Set to the current number of lines 
Initial number lines: Set to the current number of lines 
Number of modified lines: Set to zero 


The user id field is optional for options "R™ or "N™; jit is 
ignored for option "D™. If a user id is specified, it will be 
placed in the user id field of the SPF statistics. If the usar id 
is left blank and a member without SPF statistics is selected, the 
rd id field of the statistics will be set to the current user 
id. 


The rules for specifying member names are as follows: 


e Specifying a valid member name causes the statistics to be 
created or updated for a single member. 


° Leaving the member name blank causes a member listing to be 
displayed. 


& Specifying a member name of asterisk (*%)} causes the statis~- 
tics to be created or updated for all members in the library. 


If member listing is requested, the user may select members to be 
reset by entering an "5" in front of one or more member names. 
The member list may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
pressing the End PF key, which causes a return to the previous 
menu, 
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SPOOL UTILITY COPTION 3.6) 


When this option is selected Cutility option 6), a menu is dis~- 
played which allows the user to specify an SPF library or CMS file 
and indicate an action to be performed (Figure 59). 


Note: The SPF list and log files may not be specified; they may 
only be printed upon SPF termination. 


Possible actions are: 


PR - Print 

PH - Punch with header 

PJ - Punch job (no header) 
DD - Disk dump 


Option "PR" is used to print a listing file. Normally, option 
"DD" jis used to send a file to another user. Option "PH" may be 
used instead of "DD" if the file has a record length of 80 or 
less. Option "PJ" is used to sand a file to another machine for 
job execution (may be used for sending CMS jobs to a CMS batch 
machine, or JCL to a VS or DOS machine). 


An asterisk (*%) may be entered in the member name field to process 
all members of an SPF library or CMS MACLIB or TXTLIB. 


The menu also allows the user to specify: 


° To user/machine - if the data is to be spooled to the virtual 
reader of another user or machine. 


° Remote node id ~ if the other virtual machine is at a remote 
location on the network. 


t Other parms (yes/no) - to allow specification of additional 
parameters and options. 


SPOOL UTILITY 
SELECT OPTION ===> PR 


PR - PRINT PJ - PUNCH JOB (NO HEADER) 
PH - PUNCH WITH HEADER DD - DISK DUMP 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


VVvVVV 


(% FOR ALL MEMBERS) 


CMS FILE: 
FILE ID = 


==> MYPROG LISTING_ 

MEMBER ===> (* FOR ALL MACLIB/TXTLIB MEMBERS) 

IF NOT LINKED, SPECIFY: 

OWNER'S ID === DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> 
SPOOL INFORMATION: 


*TO' USER/MACHINE OTHER PARMS ===> NO (YES OR NO) 
REMOTE NODE ID 





Figure 59. Spool utility - first menu 
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When the user enters the desired information, a second menu will 
be displayed (Figure 60) if “other parms ~- yes" was specified on 
the first menu. Information on the second menu is remembered and 
pre-filled from what was entered the last time, except for "to 
user/machine”™ and "remote node id", which are simply copied from 
the first menu. 


Information which may be entered on the second menu is: 


° Print command options - if option "PR™ was specified. See 
description of PRINT command in the VM/370 CMS Command Refer- 
ence, 6020-1818. 


° Number of copies ~- if more than one copy is desired. 
® Spool class ~ for other than class A. 


° For user - to spool the output to another user's virtual 
printer on the same VM system Cignored if either "to 
user/machine” or "remote node id™ is specified). 


° 3800 keywords ~ if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in the VM/370 CP 
Command Reference, GC20-1820. 


° To user/machine —- to spool the output to the virtual reader of 
another user or machine. 


e Remote node id - if the desination is a remote node on the 
network (Cvalid with either "to user/machine"™ or "hag 
keywords", but not both). 


® Tag keywords ~ to specify control parameters for printing ona 
remote non-VM system. See description of TAG command in 
either the VM/370 Networking manual, SH20-1977, or the VM/370 
RSCS Networking manual, SH24-5005. 


If "other parms —- no" was specified on the first menu, the second 
menu is not displayed and the remembered information is not used. 


SPF will generate a PRINT, PUNCH, or DISK DUMP command Cdepending 
on the option selected) to spool the data to the specified 
desination. The first menu is then redisplayed to allow speci fi- 
cation of additional data to be spooled. If a different option 
and/or different spool parameters are specified, the spool file 
is closed (releasing the data for output) prior to generating the 
next PRINT, PUNCH, or DISK DUMP command. When the End PF key is 
pressed any remaining spooled data is released for output, and the 
user is returned to the next higher-level menu. 


Caution: Use of this utility in split screen mode should be 
avoided if the other logical screen is also being used to generate 
output for the virtual printer or punch. The data will be inter- 
mixed on the printer or punch if the user jumps back and forth 
between the two screens. No data will be lost, but the results 
may be confusing. 
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SPOOL FILE: MYPROG LISTING 
SPECIFY PARAMETERS: 
PRINT COMMAND OPTIONS ===> CC 
SPOOL OPTIONS: 


NUMBER OF COPIES 
3800 KEYWORDS 


SPOOL CLASS ===> 
CHARS TN FLASH ABCD MO 


FOR SPOOLING TO ANOTHER PERSON OR MACHINE: 
"TO" USER/MACHINE = 
REMOTE NODE ID 
TAG KEYWORDS 


Figure 60. Spool utility ~- second menu 


A "FOR' USER ===> 
D 


IFY X123_ 
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READER UTILITY COPTION 3.7) 


The reader utility allows the user to retrieve files that are on 
his virtual reader, and is especially intended to be usad to 
retrieve output (TEXT files, LISTING files, etc.) produced by the 
CMS batch machine as a result of SPF batch processing Coption 5). 


The options which are displayed when this utility is selected 
Cutility option 7) are dependent upon the status and character~- 
istics of the first active file on the user's virtual reader. 


If the first file on the reader is a TEXT file that was produced 
by an SPF batch compile or assembly Coption 5), and the source was 
from an SPF library, the options are: 


DB - Delete (purge) reader file 
L = Load file onto A-disk 
I ~- Insert batch output TEXT in SPF library 


An example of this menu is shown in Figure 61. The default option 
in this case is "I" (Cpre-entered on the menud. If option "I" is 
used, the user must specify an update password if the SPF TEXT 
library Cinto which the file is to be inserted) is on a password 
protected minidisk. 


If the user selects option "L"®, the following additional informa- 
tion may be speci fied: 


® Replace like-named file Cyes/no) - where "no" prevents a file 
with the same filename and filetype on the user's A-disk from 
being overwritten. 


° Rename to new file id - which allows the file in the virtual 
reader to be renamed (new filename and/or filetype) in the 
process of moving it to the user's A-disk. 


READER UTILITY 
‘NEXT FILE ON YOUR READER IS: MEMBER] TEXT 


SELECT OPTION ===> I 


D - DELETE (PURGE) READER FILE 

L ~- LOAD FILE ONTO A-DISK 

I - INSERT BATCH OUTPUT TEXT IN SPF LIBRARY: SPFDEMO.MOSTON. TEXT 
UPDATE PASSWORD ===> 


FOR OPTION L: 
REPLACE LIKE-NAMED FILE (YES OR NO) 
RENAME TO NEW FILE ID (A-DISK ONLY) 





Figure 61. Reader utility menu 
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The other menus displayed by this utility are similar to the one 
shown in Figure 61, except as follows: 


1. 


If the first file on the reader is not a TEXT file for which 


the source was from an SPF library, the "I" option Cand asso-~ 


ciated password field) will not be displayed. if the file was 
"disk dumped” to the virtual reader, the second option on the 
menu will be: 

L - Load file onto A-disk 


If the file was "punched" to the virtual reader, the second 
option on the menu will be: 


R - Readcard file to A-disk 


SPF automatically determines whether the file was disk dumped 
or punched. 


The second option C"L”™ or "R") will be pre-entered in the 
option field. The replace (yes/no) and rename parameters also 
apply to these menus for options "L" or "R", 


If the reader is empty, or if the first file in the reader 


cannot be processed by this utility, one of the following mas- 


sages will be displayed on the second line of the menu: 


NEXT FILE ON YOUR READER IS: READER IS EMPTY 
NEXT FILE ON YOUR READER IS: NOT CLASS A FILE 
NEXT FILE ON YOUR READER IS: FILE IN HOLD STATUS 


In these cases, the only option is to press the End PF key to 
return to the previous menu. For files which are not class A 
or which are in hold status, a CMS command may be entered Cun- 
der SPF option 6) to change the class or status. This utility 
a a be reselected to continue processing the virtual 
reader. 


When the user selects an option and presses the ENTER key, the 
first file on the user's virtual reader is processed. SPF then 
examines the next file on the reader and redisplays the appropri-~ 
ate variant of the reader utility menu, so that the next file can 
be processed. This continues until the user presses the End PF 
key to return to the next higher level menu. 
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etrie 


When this option is selected Cutility option 8), a menu is dis- 
played which allows the user to specify a tape unit and serial 
number to retrieve SPF libraries (via tape) from a TSO system 
(Figure 62). The tape drive should be attached to the user's 
machine and readied before this utility is used. 


This utility has the following options: 


1. - Retrieve all SPF libraries on the input tape 
2 ~ Retrieve selected SPF libraries from the input tape 


The tape must be a standard labeled tape created by the IEHMOVE 
utility. Any SPF/TSO library (partitioned data set with a 3-level 
name) with fixed or variable record format can be processed. SPF 
library statistics are also retrieved during the processing. 


Note: This utility may not be used to place members into an 
SPF/CMS TEXT library with organization ny CTXTLIB?. 


When the end of tape is reached, or the End or Return PF key is 
pressed, the tape is rewound but not unloaded. 


1 ~ RETRIEVE ALL SPF LIBRARIES ON THE INPUT TAPE 
@ ~ RETRIEVE SELECTED SPF LIBRARIES FROM THE INPUT TAPE 


TAPE SERIAL (MOUNT AND READY TAPE BEFORE PRESSING ENTER) 
TAPE UNIT (181, 182, 183, OR 184) 


IF OPTION '1' IS SELECTED: 
~ THE LIBRARIES MUST HAVE BEEN SPECIFIED VIA OPTION 3.2 
~ LIKE-NAMED MEMBERS ARE REPLACED, OTHER MEMBERS ARE ADDED 





Figure 62. Retrieve utility menu 


A ibrari 


For option "1" the libraries must have been previously specified 
to SPF/CMS via utility 3.2 ("specify"™ option). Project name, 
library name, and type for each SPF library on tape must exactly 
match an SPF/CMS library. Tape libraries for which no match is 
found are skipped. 
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The record length of the receiving library must be equal to or 
greater than that of the tape library, and the record formats must 
agree. Blocked record formats are accepted. 


The receiving library may be empty, or it may already contain mem- 
bers. AS members are copied from the tape into the specified 
library, new members are added and like-named members are 
replaced. 


Retrieve Selected Libraries 


For option "2" the identification of each SPF library encountered 
on tape may be reviewed at the terminal as the tape is read. The 
user may then choose to retrieve the library, skip to the next 
library on the tape, or search the tape for a specified library. 
Optionally, a library may be renamed as it is retrieved. 


If a library has not been previously specified to SPF/CMS, its 
characteristics may be specified during the retrieval process. 
For libraries which have already been specified, the rules for 
record format and length are the same as for option "1", but the 
replacement of like-named members is under user control. 


Either of two secondary menus will be displayed for each Library 
read from tape (see Figure 63). The first menu shown in the 
figure will be displayed if the library is already specified to 
SPF/CMS. The user then has the following options: 


M- Merge members from tape with the specified SPF/CMS library. 
For this options the user must specify the yes/no option for 
replacement of like-named members. (The library may be spec— 
ified and empty. ) 


I - Identify a new library name Crename option). For this option, 
a new library Cproject name, library name, and type) must be 
specified. The appropriate secondary menu will then be dis~- 
played Cor redisplayed), based on whether the new library is 
already specified to SPF/CMS, and the user may again choose 
the desired option. 


S$ - Skip to the next library on the tape. A secondary menu will 
be displayed for the next library, and the user may choose the 
desired option. 


P - Position tape to a specified library Cand skip the current 
library). For this option, the user must supply the project 
name, library name, and type for a Library on the tape. If 
the library is found a secondary menu will be displayed, and 
the user may choose the desired option. 


If the end of tape is encountered before the library is found, 
the tape is rewound and the first retrieve menu is redis-~ 
played. If the tape is positioned beyond the specified 
library, it will be backspaced to that library. 


If the library read from tape has not been specified to SPF/CMS, 
the second menu shown in Figure 63 will be displayed. The first 
option on this menu is: 


C - Create new SPF library. For this option, the library 
attributes must be specified on the lower part of the menu. 
This is the same information which may be specified under the 
file utility, option 3.2 ("specify"), except that the record 
format and length are are taken from the tape library. 


ane other options on this menu are the same as those described 
above. 
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RETRIEVE TAPE FILE: SPFDEMO.MYLIB.PLI ------------~---~-~---~--~-~ wneen enn 
SELECT OPTION === 


MERGE WITH EXISTING LIBRARY NAMED: SPFDEMO.MYLIB.PLI 
IDENTIFY ALTERNATE LIBRARY NAME BELOW 

SKIP TO THE NEXT LIBRARY ON TAPE 

POSITION THE TAPE TO THE SPF LIBRARY NAMED BELOW 


SPF LIBRARY: (TAPE LIBRARY RECFM: F  LRECL: 80 
PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ==> PLI 


UPDATE PASSWORD ===> 


REPLACE LIKE-NAMED MEMBERS ===> NO {YES OR NO) 


RETRIEVE TAPE FILE: SPFDEMO.XXX.COBOL 
SELECT OPTION ===> _ 


CREATE NEW SPF LIBRARY NAMED: SPFDEMO.XXX.COBOL 
IDENTIFY ALTERNATE LIBRARY NAME BELOW 

SKIP TO THE NEXT LIBRARY ON TAPE 

POSITION THE TAPE TG THE SPF LIBRARY NAMED BELOW 


ted 


SPF LIBRARY: (EXISTING LIBRARY RECFM: F  LRECL: 80 
PROJECT 
LIBRARY 
TYPE 


UPDATE PASSWORD ===> 


SPECIFY LIBRARY ATTRIBUTES: 
ORGANIZATION =ss=> § (S=SET OF FILES, M=MACLIB) 
ORNER'S ID KLEIN (BLANK FOR YOUR USERID) 
DEVICE ADDR. ' (BLANK FOR '191') 
LINK ACCESS MODE Ww (SPECIFY ‘WW’, 'M', OR ‘MW’ FOR UPDATE ACCESS) 
CMS FILETYPE COBOL. (IF ORG 'S* - BLANK FOR SPF ASSIGNED FILETYPE) 
CMS MACLIB NAME . CIF ORG 'M*® - BLANK FOR SPF ASSIGNED FILENAME) 


ian a 
VvVVVY 


toda 
“twat 





Figure 63. Retrieve utility ~- secondary menus 
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SCRIPT/VS UTILITY COPTION 3.9) 


When this option is selected (utility option 9), a sequence of 
menus is displayed to allow formatting, displaying, and printing 
of text maintained in SPF libraries or sequential CMS files. Use 
of this utility requires the installation of the Document Compos~ 
ition Facility (CSCRIPT/VS), program product 5748-XX9, with the 
Foreground Environment Feature. 


This utility has the following options: 


1 - Draft document options 
2 -~ Final document options 


In the draft document option, it is assumed that the primary 
interest of the user is to assure that the content, syntax, and 
spelling within the document are correct. The final document 
option provides additional flexibility and control for the user 
interested in specific document formats. 


The SCRIPT/VS selection menu is used to select the draft or final. 
document option, and to specify the library or file to be format- 
ted (Figure 64). For SPF libraries, if a member name is not specy 
ified, a member List will be displayed. A concatenated sequence 
of SPF libraries may be specified to allow inclusion of imbedded 
or appended members from more than one library. 


Any SPF libraries to be processed by this utility must have an 
organization. of "S$" (set of sequential files). They need not have 
an SPF type qualifier of SCRIPT, and the corresponding set of 
sequential files need not have a filetype of SCRIPT. If, however, 
a CMS file id is specified (Con the second part of the menu) it 
must have a filetype of SCRIPT, and any imbedded Cor appended) 
files must also have a filetype of SCRIPT unless they are explic~ 
itly defined via a ".dd" control word. 





SELECT OPTION ===> 


1 ~ DRAFT DOCUMENT OPTIONS 2 ~ FINAL DOCUMENT OPTIONS 


SPF LIBRARY TO BE FORMATTED: 
PROJECT 
_ LIBRARY ==> 
TYPE 
MEMBER (BLANK FOR MEMBER SELECTION LIST) 


CMS FILE TO BE FORMATTED: 
FILE ID ===> 
IF NOT LINKED SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> ACCESS MODE ===> 


READ PASSHORD ===> 


OUTPUT LISTING FILE: (DEFAULT IS 'MEMBER/FILENAME LISTING A')} 
FILE ID ===> 





Figure 64. SCRIPT/VS selection menu 
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Processing Sequence 


The processing sequence for the SCRIPT/VS utility is as follows: 


1. The user enters the appropriate information on the SCRIPT/VS 
selection menu, and presses the ENTER key. 


2. A secondary menu is displayed for either the "draft" or 
"final" document options, depending on which option was spec~ 
ified on the first menu. The user enters the appropriate 
information on the secondary menu (see below) and presses the 
ENTER key. 


3. The SCRIPT/VS formatter is invoked. If the "quiet™ option has 
not been specified, the screen is blanked and a one-line mas- 
sage is displayed, indicating that SCRIPT/VS processing has 
started. When processing im complete, a "MORE..." message is 
displayed in the lower right-hand corner of the screen. The 
user then presses PA2. 


4. The formatted output is displayed in browse mode. The output 
may be scrolled using the Scroll PF keys. All browse commands 
may be entered. When the user has finished browsing the out-— 
put, he presses the End PF key. 


5. The SCRIPT/VS print menu is then displayed to allow the for- 
matted output to be printed, kept, or deleted. The user 
enters the appropriate information on this menu (see below) 
and presses the ENTER key. 


6. The specified action (print, keep, or delete) is taken and the 
SCRIPT/VS selection menu is redisplayed. The user may then 
format additional documents, or press the End PF key to return 
to a higher level menu. 


Draft Document Options 
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When option 1 is selected on the SCRIPT/VS selection menu, a secy 
ondary menu is displayed to allow the user to specify the draft 
Ska pele options (Figure 65). All the parameters on this menu are 
optional. 


For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv" command in the SCRIPT/VS 
User's Guide.) 


For all upper case printing, "yes" is entered in the upper casa 
only field. 


For line numbers to be printed in the output document, "yes" is 
entered in the line number field. Line numbers can be useful for 
correcting errors and mis~spelled words, which SCRIPT/VS identi- 
fies by line number. 


Use of the "other SCRIPT parms" field allows input of any 
SCRIPT/VS parameters not on the menu. The NOPROF option should 
not be specified if the source is from an SPF library. 


If a SCRIPT/VS document profile is to be used, the user must enter 
the nama of the CMS file which contains the profile in the "pro- 
file" field. A file id of PROFILE SCRIPT should be entered for the 
default profile. 


To incorporate one or more user GML library in formatting the 
data, the user must enter the filename(s) in the "symbol/macro 
lib" field. These files must be MACLIBs. If no files are speci- 
fied, the default GML library, if any, will be used. 
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ween ee eee ene eee eee SCRIPT/VS DRAFT DOCUMENT OPTIONS ~~-----------~---------- 
FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 


SCRIPT/VS DRAFT OPTIONS: 
SPELLING CHECK 
UPPER CASE ONLY 
LINE NUMBER 


==> NO (YES OR NO) 
==> YES (YES OR NO) 
==> YES (YES OR NO) 


OTHER SCRIPT PARMS ===> 
PROFILE FILE ID ===> 


SYMBOL/MACRO "LIB" FILE NAMES: 
ss=> GML 


Figure 65. SCRIPT/VS draft document options menu 


Final Document Options 


When option 2 is selected on the SCRIPT/VS selection menu, a secy 
ondary menu is displayed to allow the user to specify the final 
document options (Figure 66). All the parameters on this menu are 
optional. However, if a device type is entered, the lines per 
inch and form definition fields must be correctly filled in. 


For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv"™ command in the SCRIPT/VS 
User's Guide. } 


For all upper case printing, "yes" is entered in the upper case 
only field. ; 


The next four fields on the menu are used to describe the output 
davice and the physical characteristics of the printed page. The 
type of printer on which the output will be printed Cand for which 
SCRIPT/VS will format the document) is specified in the "device 
type” field. If the document is to be printed on a device other 
than an IBM 1403 or 3800, this field should be left blank, and the 
eee should be specified in the "other SCRIPT parms™ field (see 
elow). 


The "lines/inch", "form width™ and "form length" fields are used 
to describe how the document should physically fit on the printed 
page, 


The "3800 chars parm" field is used to specify the type font(s) if 
the the document is being formatted for an IBM 3800 printer. The 
user may enter one or two SCRIPT/VS fonts or up to four 3800 char- 
acter arrangement tables. 
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The user may specify the page margin to be used in binding the 
document by entering the size of the margin in the "binding"™ 
fields. <A different margin can be specified for even and odd num 
bered pages. For more information, see "BIND”™ in the SCRIPT/VS 
User's Reference Guida. 


Use of the "other SCRIPT parms"™ field allows input of any 
SCRIPT/VS parameters not on the menu. The NOPROF option should 
not be specified if the source is from an SPF library. 


If the "other SCRIPT parms” field is used to specify a device oth- 
er than the 1403 or 3800, the device must have been previously 
added to the SCRIPT/VS device characteristics table. A device may 
be selected from this table by leaving the "device type" field of 
the menu blank and specifying the SCRIPT/VS device parameter in 
the "other SCRIPT parms" field. 


If a SCRIPT/VS document profile is to be used, the user must enter 
the name of the CMS file which contains the profile in the "pro- 
file" field. A file id of PROFILE SCRIPT should be entered for the 
default profile. 


To incorporate one or more user GML library in formatting the 
data, the user must enter the filename(s) in the "symbol/macro 
lib" field. These files must be MACLIBs. If no files are speci-~ 
fied, the default GML library, if any, will be used. 


SCRIPT/VS FINAL DOCUMENT OPTIONS 
FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 


SCRIPT/VS FINAL OPTIONS: 
SPELLING CHECK 
UPPER CASE ONLY 
DEVICE TYPE 

. LINES/INCH 
PAGE WIDTH 
PAGE LENGTH 
3800 "CHARS" PARM 


VvVVVYV VY ¥ 


(YES OR NO} 

(YES OR NO) 

(1403 OR 3800} 

(6, 8» OR 12) 
(8.5, 11, OR 13.5) 
(8.5 OR 11) 


me OW ee ZiZ 

£oo 
t,o) 
ul 


~~ 2 


enn at aod 
ot a Wt ek 
“on dm wn as 


BINDING: ODD PAGE (SPECIFY MARGIN} 
EVEN PAGE (SPECIFY MARGIN) 


OTHER SCRIPT PARMS 


PROFILE FILE ID 


SYMBOL/MACRO "LIB" FILE NAMES: 
=s==> GML 





Figure 66. SCRIPT/VS final document options menu 
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SCRIPT/VS Print Options 


When the user has finished browsing the formatted document, 
pressing the End PF key will cause the SCRIPT/VS print menu to be 
displayed (Figure 67). On this menu, the "file id" field shows 
the id of the output listing file, as specified on the SCRIPT/VS 
selection menu. This file contains the formatted text to be proc” 
essed (print and delete, delete, or keep) as specified on this 
menu. 


If option "P" Cprint file) is salected, the following spool param- 
eters may be specified: 


° Number of copies ~- if more than one copy is desired. 
° Spool class - for other than class A. 


e For user - to spool the output to another user's virtual 
printer on the same VM system (Cignored if either "to 
user/machine™ or "remote node id” is specified). 


e 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in the VM/370 CP 
Command Reference, GC20-1820. 


e To user/machine ~- to spool the output to the virtual reader of 
another user or machine. 


° Remote node id - if the desination is a remote node on the 
network (Cvalid with either "to user/machine"™ or Wtag 
keywords", but not both). 


° Tag keywords - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 
either the VM/370 Networking manual, SH20-1977, or the VM/370 
RSCS Networking manual, SH24-5005. 


SELECT OPTION ===> P 


P - PRINT FILE CAND DELETE) 
K - KEEP FILE ~ DO NOT PRINT 
D - DELETE (ERASE) FILE ~- DO NOT PRINT 
BLANK AND END KEY DELETES FILE WITHOUT PRINTING 


FILE ID: DOCXYZ LISTING Al 


SPOOL OPTIONS: 
NUMBER OF COPIES SPOOL CLASS ===> A "FOR’ USER ===> 
3800 KEYWORDS CHARS TN_ 


FOR SPOOLING TO ANOTH ERSON OR MACHINE: 
"TO' USER/MACHINE 
REMOTE NODE ID 
TAG KEYWORDS 





Figure 67. SCRIPT/VS print menu 


UTILITIES COPTION 3) 129 


FOREGROUND PROCESSING COPTION 4) 


The foreground option provides an interface with standard lan- 
guage processors for foreground compilation and assembly of pro- 
grams stored in SPF libraries or CMS files. It also provides a 
menu interface to the FORTRAN and COBOL interactive debug facili- 
ties, and to the CMS LOAD command. 


When foreground is selected (primary option 4), a secondary menu 
is displayed to allow the user to select a language processor 
(Figure 68). It is possible to bypass the secondary menu by enter- 
ing two numbers, separated with a decimal point, on the primary 
option menu. For example, entering 4.3" on the primary menu has 
the same effect as entering "4" on the primary menu and "3" on 
secondary menu. 


FOREGROUND SELECTION MENU 
SELECT OPTION == 


SYSTEM ASSEMBLER PL/I OPTIMIZING COMPILER 
OS/VS COBOL COMPILER LOAD 

FORTRAN IV (G1) COMPILER COBOL INTERACTIVE DEBUG 
PL/I CHECKOUT COMPILER FORTRAN INTERACTIVE DEBUG 





Figure 68. Foreground selection manu 


When a language processor has been selected, a menu is displayed 
to allow the user to specify SPF library information or CMS 
filename, and processor options. Figure 69 shows an example for 
Assembler. The project name, first library name, type qualifier, 
and member name must be specified to assemble a program whose 
source is in an SPF library. The filename must be specified to 
assemble a CMS file with a filetype of ASSEMBLE. (CIf the CMS 
filename is entered, it overrides any SPF library speci fication. ) 
The other parameters are optional, except as noted below. 


Once the processor menu has been filled in and the ENTER key has 
been pressed, the appropriate language processor is invoked. The 
GLOBAL command and the command that invokes the language process~ 
or will be displayed, as will certain other output of the language 
processor (depending on the options chosen), such as error mes~ 
sages, prompts, and return codes. Any communication with the lan- 
guage processor is in line I/O mode. 
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we renee nee n ene n nee FOREGROUND ASSEMBLY ---------------------~-------- 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 


PROJECT ===> SPFDEMO 

LIBRARY ===> XXX ===> TEST ===> MASTER =E=> 

TYPE ===> ASM 

MEMBER ===> TOP 
CMS FILE: 

FILENAME ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR, ===> LINK ACCESS MODE ===> 
READ PASSWORD ===> UPDATE PASSWORD ===> 


ASSEMBLER OPTIONS: 
===> LIST NODECK OBJECT 


ADDITIONAL CONCATENATED MACLIBS: 
===> CMSLIB (===> OSMACRO ===> ===> 


Figure 69. Foreground ~- Assembler example 


Upon completion of the foreground processing, a "MORE...™ message 
will be displayed in the lower right-hand corner of the screen. 
The user may then press the PA2 key to return to the foreground 
processor menu. 


When the foreground processor menu is redisplayed, a message 
indicating completion of the process is displayed in the upper 
right-hand corner of the screen. The user may then enter another 
foreground processing request or press the End PF key to return to 
the previous menu. 


ASSEMBLER/COMPILER PROCESSING 


The Assembler menu shown in Figure 69 is typical of the language 
processor menus. In the figure, a library concatenation sequence 
of three data sets has been specified. The concatenation order 
is: 


SPFDEMO.XXX.ASM 
SPFDEMO.TEST.ASM 
SPFDEMO.MASTER.ASM 


Note: The SPF type qualifier for an assembler source library need 
not be ASSEMBLE, as illustrated in the example. 


Before invoking the foreground processor, SPF will scan the con- 
catenated sequence of libraries to find the member to be assembled 
or compiled (member TOP in this example). A CMS. file with a 
filetype acceptable to the language processor CASSEMBLE in this 
example) will be created on the user's A-disk by extracting the 
member from the first library in the sequence in which it occurs. 
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For any library in the sequence that is a collection of sequential 
files, a MACLIB is created on the user's A~disk to enable the use 
of COPY or INCLUDE statements. (For performance reasons, it is 
recommended that high-level libraries be specified as MACLIBs.) 


Any temporary files created by SPF will be erased at the com 
pletion of the foreground process. 


For this example, if SPFDEMO.XXX.ASM is a colletion of sequential 
files and the higher-level libraries are already MACLIBs, the 
GLOBAL command preceding the ASSEMBLE command might look like: 


GLOBAL MACLIB SPF00511 TEST MASTER CMSLIB OSMACRO 


where SPF00511 is the SPF generated filename for the MACLIB con- 
taining all the members of SPFDEMO.XXX.ASM. 


Note the following points: 


1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be assembled, and it 
allows inclusion of subsidiary members referenced by COPY 
statements in the assembler source. 


2. Other MACLIBs can be: appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the "additional concatenated MACLIBs" fields. 


3. If the source is from an SPF library, the TEXT file is placed 
in an SPF library with a three-level name composed of the 
project name, the first library name, and a type qualifier of 
TEXT. The SPF member name for the TEXT file is the same as 
the source member. The LISTING file is placed on the user's 
A-disk. Its filename is the same as the source member name. 


4. If the source is specified as a CMS file (rather than an SPF 
library), the filetype must be whatever is acceptable to the 
language processor (ASSEMBLE in this example). The resulting 
TEXT and LISTING files are placed on the user's A-disk. 


5. In specifying a CMS file that would require a LINK and ACCESS, 
the user must provide the necessary LINK information: The 
user id of the owner, the virtual device address of the mini- 
disk on which the source resides, and the desired link access 
mode Ce.g, RR). 


6. The language processor options are passed to the processor 
exactly as specified by the user. Up to 16 tokens may be 
specified as processor options. Only those options specified 
on the menu are passed to the language processor; SPF does not 
automatically generate any options. 


The processor menus for COBOL, FORTRAN, and the two PL/I compilers 
are similar to the one for Assembler. The meanings of the options 
differ among the several language processors. Check the user's 
saan the specific language for an explanation of the process~ 
or options. 


Compiler output is handled differently in the following casas: 


e When the TEST option is specified for the FORTRAN compiler, a 
special TEXT file is produced for later use by the FORTRAN 
interactive debug facility. The file is not placed in an SPF 
library. Rather, it is left on the user's A-disk, as is the 
generated FORTRAN file. 


® When the TEST option is specified for the COBOL compiler, a 
SYSUT5 file is produced for later use by the COBOL interactive 
debug facility. The file is placed on the user's A-disk. 


° When the OBJECT option is specified for the PL/I Checkout com- 
piler, a special TEXT file (a “link edit stub") and an ITXTLIB 
file Cinterpretable text) are produced for later use with the 
PLICR command. Both files are placed on the user's A-disk. 
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The menus for the interactive debug facilities differ somewhat 
from the other foreground menus: 


° The COBOL interactive debug menu allons specification of up 
to four additional program ids (which must match the external 
filenames), and PRINT and SOURCE options which determine what 
FILEDEFs are generated by SPF. Also allowed are 15 tokens of 
execution parameters that are stacked for use by the process~ 
or, and the specification of up to four additional TXTLIBs. 


e The FORTRAN interactive debug menu allows variations of the 
DISK or PRINT options, the specification of up to four addi-~ 
tional filenames, and the specification of up to four TXTLIBs 
to be included in the GLOBAL TXTLIB command. 


LOAD PROCESSING 


This foreground option Coption 4.6) provides a menu interface to 
the LOAD command CFigure 70). The menu allows a simple LOAD and 
GENMOD command to be issued with the specified options, or a 
user-specified EXEC to be issued for more complex load functions 
with multiple filenames, INCLUDES, etc. 


ENTER/VERIFY PARAMETERS BELON: 


SPF LIBRARY: 
PROJECT 
LIBRARY ==s> TEST 
TYPE 
MEMBER 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> 


USER EXEC (USER'S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD } 
OPTIONS: 

LOAD > CLEAR MAP 

GENMOD > MAP 


ADDITIONAL CATENATED TXTLIBS: 


s=s> 





Figure 70. Foreground — LOAD menu 
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BATCH PROCESSING COPTION 5) 


The batch option provides an interface with standard language 
processors for compilation and assembly in the CMS batch machine 
of programs stored in SPF libraries or CMS files. It also pro- 
vides a menu interface for batch execution of the CMS LOAD com- 
mand. 


When batch is selected (primary option 5), a menu is displayed to 
allow the user to select a language processor, and to enter and/or 
verify job statement parameters (Figure 71). When the user 
enters the desired information and presses the ENTER key, SPF dis~ 
plays the appropriate processor menu. 


It is possible to bypass the secondary menu by entering two num- 
bers, separated by a decimal point, on the primary option menu. 
For example, "5.2" to select a batch COBOL compile. Note, howev- 
er, that use of this procedure does not allow verification or 
changes to the job statement parameters, nor does it allow the 
generation of multiple compilations Cmultiple job steps) within 
the same job. 


SELECT OPTION ===> 


1 ~ SYSTEM ASSEMBLER 4& - PL/I CHECKOUT COMPILER 
2 - OS/VS COBOL COMPILER 5 - PL/I OPTIMIZING COMPILER 
3 - FORTRAN IV (GL) COMPILER 6 - LOAD 


BATCH JOB INFORMATION: (ENTER OR VERIFY BEFORE PROCEEDING) 
(YOUR CMS USER ID AUTOMATICALLY BECOMES YOUR BATCH JOB USER ID.} 


BATCH MACHINE ID ===> CMSB 
JOB STATEMENT INFORMATION: 


ACCOUNT NUMBER 
JOB NAME 





Figure 71. Batch selection menu 


When job information has been entered and a language processor 
selected, a menu is displayed to allow the user to specify SPF 
library information or CMS filename, and processor options. 
Figure 72 shows an example for the PL/I optimizing compiler. The 
project name, first library name, type qualifier, and member name 
must be specified to compile a program whose source is in an SPF 
library. The filename must be specified to compile a CMS file 
with a filetype of PLI or PLIOPT. CIf the CMS filename is 
entered, it overrides any SPF library specification.) The other 
parameters are optional, except as noted below. 
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BATCH PLI OPTIMIZING COMPILE 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT SPFDEMO 
LIBRARY ===> V3TEST ===> MASTER 
TYPE 
MEMBER TOPSEG_ 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED IN YOUR LOGON DIRECTORY, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSWORD ===> 


COMPILER OPTIONS: 
===> MACRO OBJECT SOURCE XREF 


ADDITIONAL CONCATENATED MACLIBS: 


s==> ==s=5> 





Figure 72. Batch ~ PL/I optimizing compiler example 


When the user has filled in the menu entries and pressed the ENTER 
key, SPF generates the appropriate commands to be run in the batch 
machine. After SPF has generated the commands, it returns to the 
‘batch selection menu Cunless that menu was bypassed by entering 
two numbers on the primary menu), with a message "job step gener- 
ated" displayed in the short message area (line 1). If the batch 
selection menu was bypassed, SPF submits the generated commands 
and returns to the primary option menu. In either case, the user 
may exit from the processor menu without generating any commands 
by pressing the End PF key rather than the ENTER key. 


When the batch menu is redisplayed, the job statement parameters 
are shown for information only ~- they are no longer intensified 
and may not be overtyped. At this point, the user may select 
another processor to cause more commands Canother job step) to be 
generated, enter CANCEL to return to the primary option menu with- 
out submitting the job, or press the End PF key Cor Return PF key) 
to cause the generated commands to be submitted to the batch 
machine for execution. 


If the job is submitted, a confirmation message is displayed, 
accompanied by a "HOLDING" message in the lower right-hand corner 
of the screen. When the user presses the PA2 key, SPF returns to 
the the primary option menu. 


The batch machine sends messages to the user indicating the 
progress of the job. When the job has completed, the SPF reader 
utiltiy Coption 3.7) may be used to retrieve TEXT and LISTING 
files produced by the batch job. 


Caution: Use of the batch processing option in split screen mode 
should be avoided if the other logical screen is also being used 
to generate output for the virtual punch. The data will be inter- 
mixed on the punch if the user jumps back and forth between the 
screens. No data will be lost, but the results may be confusing. 
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ASSEMBLER/COMPILER PROCESSING 
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The compiler menu shown in Figure 72 is typical of the batch 
language processor menus. In the figure, a library concatenation 
sequence of three libraries has been specified. The concat~ 
enation order is: 


SPFDEMO.LARRY.PLI 
SPFDEMO.V3TEST.PLI 
SPFDEMO.MASTER.PLI 


Before invoking the batch process, SPF will scan the concatenated 
sequence of libraries to find the member to be assembled or com- 
piled (member TOPSEG in this example). A CMS file with a filetype 
acceptable to the language processor (PLI in this example) will be 
created on the user's A-disk by extracting the member from the 
first library in the sequence in which it occurs. 


For any library in the sequence that is a collection of sequential 
files, a MACLIB will be created on the batch machine's A-disk to 
enable the use of COPY or INCLUDE statements. (For performance 
deg ie is recommended that high-level libraries be specified 
as MACLIBs.) 


Any temporary files created by SPF will be erased at the com- 
pletion of the batch process. 


Note the following points: 


1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be compiled, and it allows 
inclusion of subsidiary members referenced by INCLUDE state- 
ments in the PL/I source. 


2. Other MACLIBs can be appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the “additional concatenated MACLIBs” fields. 


3. The TEXT and LISTING files produced by the batch process are 
placed in the user's virtual reader using the DISK DUMP com- 
mand. The SPF reader utility Coption 3.7) may be used to 
retrieve these files following completion of the job. 


4. If the source is specified as a CMS file Crather than an SPF 
library), the filetype must be whatever is acceptable to the 
language processor (PLI or PLIOPT in this example). 


5. In specifying a CMS file that would require a LINK and ACCESS 
Ci.e., if the file is on a minidisk not defined by an MDISK or 
LINK statement in the user's own LOGON directory), the user 
must provide the necessary LINK information: The user's id 
whose directory does contain that information, the virtual 
device address of the minidisk on which the source resides, 
and the desired link access mode (e.g, RR). 


6. The language processor options are passed to the processor 
exactly as specified by the user. Up to 15 tokens may be 
specified as processor options. Only those options specified 
on the menu are passed to the language processor; SPF does not 
automatically generate any options. 


The processor menus for Assembler and other compilers are similar 
to the one for the PL/I Optimizer. The meanings of the options 
differ among the several language processors. Check the user's 
guide for the specific language for an explanation of the Proes=s" 
or options. 


Compiler output is handled ai €farently in the following cases: 


e When the TEST option is specified for the FORTRAN compiler, a 
special TEXT file is produced for later use by the FORTRAN 
interactive debug facility. The file is punched to the user’s 
virtual reader, as is the generated FORTRAN file. 
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e When the TEST option is specified for the COBOL compiler, a 
SYSUT5 file is produced for later use by the COBOL interactive 
spetaperd facility. The file is punched to the user's virtual 
reader. : 


e When the OBJECT option is specified for the PL/I Checkout com- 
piler, a special TEXT file (a "link edit stub”) and an ITXTLIB 
file Cinterpretable text) are produced for later use with the 
Coen command. Both files are punched to the user's virtual 
reader. 


LOAD PROCESSING 


This batch option Coption 5.6) provides a menu interface to the 
LOAD command (Figure 73). The menu allows a simple LOAD and 
GENMOD command to be issued with the specified options, or a 
user-specified EXEC to be issued for more complex load functions 
with multiple filenames, INCLUDEs, etc. 


PROJECT 

LIBRARY =s=> TEST 
TYPE 

MEMBER 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED IN YOUR LOGON DIRECTORY, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSHORD ===> 


USER EXEC == (USER'S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD) 

OPTIONS: 
LOAD = 
GENMOD = 


=> CLEAR MAP 
=> MAP 


ADDITIONAL CONCATENATED TXTLIBS: 


===> ===> 





Figure 73. Batch - LOAD menu 
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CMS COMMAND COPTION 6) 


The CMS command option allows direct entry of a CMS command, CP 
command, EXEC, or entry to CMS subset under SPF. When this option 
is selected (primary option 6}, the CMS command menu is displayed 
(Figure 74). 


COMMAND AND EXEC PROCESSING MENU 
ENTER COMMAND BELOW: 


==5> = 


ANY ONE OF THE FOLLOWING MAY BE ENTERED: 


A CMS COMMAND 

A CP COMMAND 

AN EXEC SPECIFICATION 

CMS (TO ENTER CMS SUBSET MODE, USE RETURN COMMAND TO 


RETURN FROM SUBSET TO SPF) 





Figure 74. CMS command menu 


The command or EXEC is entered to the right of the arrow, using 
standard CMS syntax. It may be continued on the next two lines, 
if necessary. Entering "CMS" causes entry to the CMS subset. The 
user exits from the CMS subset by issuing a RETURN command. While 
in subset mode, the PF keys and PA keys revert to standard CMS 
definitions. 


After the CMS command has been typed, the user may press the ENTER 
key to cause execution of the command. Typically, the command and 
any resulting output will be displayed on the screen as if the 
command had been entered in a normal CMS environment. (The return 
code presentation may appear slightly different.) Following the 
last line displayed by the command, a "MORE..." message will be 
displayed in the lower right-hand corner of the screen. The user 
should then press PA2. 


When the PA2 key is pressed, the menu is redisplayed. The command 
which was just executed is pre-entered to the right of the arrow. 
The user may then enter another command, or press the End PF key 
to return to the primary option menu. 


Option 6 should not be used for entering SPF recursively, logging 


off, or issuing commands of a privileged class beyond the user's 
class. The results of any of the above are unpredictable. 
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TUTORIAL COPTION 7) 


The tutorial option provides immediate online reference and 
instruction on how to use SPF. It may be invoked from the primary 
option menu or via the Help PF key. The tutorial may be viewed 
sequentially from beginning to end, or it may be viewed randomly 
by ete es specific topics from an alphabetic index or table of 
contents. 


When the tutorial is invoked from the primary option menu Coption 
7), introductory pages are displayed to explain how the tutorial 
works (Figure 75). Following the introduction, a table of 
contents is displayed from which the user may select a topic by 
entering the desired section number. 


When the tutorial is invoked via the Help PF key, the appropriate 
section of the tutorial is entered based on what the user was 
doing when he pressed Help. 


During execution of the tutorial, the four scroll PF keys are 
interpreted as follows: 


UP 

DOWN 

LEFT Cbhack) 
RIGHT (next) 


display higher level list of topics 
not used 

display previous tutorial page 
display next tutorial page 


Thea Help PF key may be pressed at any time to display a one-page 
summary of how to use the tutorial. 


The tutorial function is terminated by pressing the End PF key. 
This causes a return either to the primary option menu or to the 
display from which the user requested help. 


Note: Each page of the tutorial is formatted to occupy 23 lines of 
the screen. If the tutorial is viewed in split-screen mode on a 
24 line screen, the split line should be positioned either to the 
top or bottom line of the screen. 
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STRUCTURED PROGRAMMING FACILITY 


TUTORTAL 


THIS TUTORIAL PROVIDES ON-LINE INFORMATION ABOUT THE FEATURES AND OPERATION 
OF SPF. YOU MAY VIEW THE TUTORIAL SEQUENTIALLY, OR YOU MAY CHOOSE SELECTED 
TOPICS FROM LISTS WHICH ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. 


THE TABLE OF CONTENTS CONTAINS A LIST OF MAJOR TOPICS. SUBSEQUENT PAGES 
CONTAIN ADDITIONAL LISTS WHICH LEAD YOU TO MORE SPECIFIC LEVELS OF DETAIL. 
TOPICS MAY ALSO BE SELECTED FROM THE TUTORIAL INDEX. 


THE NEXT TNO PAGES CONTAIN A DESCRIPTION OF HOW TO USE THIS TUTORIAL. 
PRESS ENTER TO PROCEED TO THE NEXT PAGE, OR 


PRESS UP KEY TO GO DIRECTLY TO THE TABLE OF CONTENTS, OR 
PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU. 


TUTORTAL TUTORIAL 
NEXT SELECTION ===> _ 


YOU MAY VIEW THE TUTORIAL SEQUENTIALLY BY SIMPLY LEAVING THE “NEXT SELECTION" 
FIELD BLANK AND PRESSING THE ENTER KEY. ALTERNATIVELY, YOU MAY SELECT TOPICS 
FROM LISTS WHICH ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. FOR EXAMPLE, 
ENTER: NEXT SELECTION ===> 3 TO SELECT TOPIC 3. 


YOU MAY ALSO ENTER ONE OF THE FOLLOWING CODES IN THE "NEXT SELECTION" FIELD 
ON ANY TUTORIAL PAGE: 
BACK OR B - TO BACK UP TO THE PREVIOUSLY VIENED PAGE. 
OR S$ - TO SKIP THE CURRENT TOPIC AND GO ON TO THE NEXT TOPIC. 
OR U ~ TO DISPLAY A HIGHER LEVEL LIST OF TOPICS. 
OR T - TO DISPLAY THE TABLE OF CONTENTS. 
OR £ - TO DISPLAY THE TUTORIAL INDEX. 


(CONTINUED ON NEXT PAGE) 





Figure 75. Tutorial - first 2 pages 
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A: SAMP PROB 


This sample problem is a brief scenario of SPF terminal operations 
(Figure 76 through Figure 78). It is intended to serve as a dem- 
onstration that SPF has been properly installed and is opera- 
tional. It may also be useful for new users as a quick 
introduction to SPF. 


The scenario requires the installation of file SAMPLE ASSEMBLE 
Cincluded on the SPF basic distribution tape), which should be 
available for read-only access on the SPF system mini-disk. 


Prior to starting this sample problem, you should make sure that 
there are no files in your virtual reader. 
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ACTION RESULT 


1. 


LOGON AND IPL CMS (IF REQUIRED) 
TYPE "SPF" 

SELECT UTILITIES (OPTION 3) 
SELECT FILE UTILITY (OPTION 2) 


SELECT "SPECIFY" (S) AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID (YOUR VM USERID) 
TYPE ; ASM 


ENTER THE FOLLOWING: 
ORGANIZATION S 
RECORD FORMAT F 
RECORD LENGTH 8&0 

LINK ACCESS MODE : W 
(LEAVE OTHER FIELDS BLANK) 


ee 08 @¢ of 


SELECT "SPECIFY" AGAIN AND ENTER: 
PROJECT : SAMPLE (SAME AS BEFORE) 
LIBRARY : USERID (SAME AS BEFORE} 
TYPE : TEXT 


(SAME ORGANIZATION, RECORD FORMAT; 
RECORD LENGTH, AND MODE LETTER 
SHOULD BE PRE-ENTERED). 

PRESS ENTER KEY. 


PRESS PF3 CEND KEY) 
PRESS PF3 
SELECT MOVE/COPY (OPTION 3.3) 


SELECT COPY (C) AND ENTER: 
CMS FILE ID : SAMPLE ASSEMBLE 


BLANK OUT CMS FILE ID AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID (YOUR VM USERID) 
TYPE ASM 

MEMBER ASNTEST 


° 
° 
. 
2 
e 
° 
. 
. 


PRESS PF3 

SELECT BROWSE (OPTION 1) 

BLANK OUT CMS FILE ID AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID 


TYPE ASM 


MEMBER (LEAVE BLANK) 


SELECT MEMBER ASMTEST 
(ENTER S AHEAD OF MEMBER NAME) 


SCROLL FORWARD ONE PAGE (PF8) 
SCROLL BACKWARD ONE PAGE (PF7) 


ENTER COMMAND INPUT :; 
===> FIND COMMENT 


FIND NEXT OCCURRENCE OF "COMMENT" 


_ BY PRESSING PF5 


Figure 76. 
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1. READY MESSAGE 
SPF PRIMARY OPTION MENU 
UTILITY SELECTION MENU 
‘FILE UTILITY MENU 


SPECIFY NEW LIBRARY MENU 


"SAMPLE .USERID.ASM' IS 
SPECIFIED AS AN SPF 
LIBRARY. FILE UTILITY 
MENU IS REDISPLAYED. 


SPECIFY NEN LIBRARY MENU 


"SAMPLE .USERID.TEXT' IS 
SPECIFIED AS AN SPF 
LIBRARY. FILE UTILITY 
MENU IS REDISPLAYED. 


UTILITY SELECTION MENU 
SPF PRIMARY OPTION MENU 
MOVE/COPY UTILITY MENU 
SECOND MOVE/COPY MENU 
SAMPLE ASSEMBLE FILE IS 
COPIED TO YOUR LIBRARY 
(SAMPLE.USERID.ASM) AS 
MEMBER ASMTEST. 

THE FIRST MOVE/COPY MENU 
IS REDISPLAYED. 

SPF PRIMARY OPTION MENU 
BROWSE DATASET MENU 
BROWSE MEMBER SELECTION 
LIST OF SPF LIBRARY 
'SAMPLE.USERID. ASM". 

ONLY ONE MEMBER (ASMTEST) 
IN LIST. 


BROWSE DATA DISPLAY OF 
SAMPLE .USERID.ASM(C ASMTEST) 


SECOND PAGE OF ASMTEST 
FIRST PAGE OF ASMTEST AGAIN 


STRING "COMMENT" IS 
INTENSIFIED. 


SECOND OCCURRENCE OF 
"COMMENT" IS INTENSIFIED. 





Sample problem scenario (part 1 of 3) 


PRESS PF3 

PRESS PF3 

PRESS PF3 

SELECT EDIT (OPTION 2) 
ENTER SPF LIBRARY: 
PROJECT : SAMPLE 
LIBRARY : USERID 
TYPE : ASM 
MEMBER : ASMTEST 

FIND THE LINE CONTAINING THE 
STRING “COMMENT' BY USING THE 
COMMAND ===> FIND COMMENT 


DELETE THE COMMENT BY PRESSING 
ERASE EOF 


REPEAT THE NEXT COMMENT LINE BY 
OVERTYPING THE FIRST DIGIT OF 
THE LINE NUMBER WITH "R". 

ENTER THE COMMAND ===> PRINT ON 
TRY OUT MORE EDIT COMMANDS IF 
YOU LIKE, BUT REMEMBER THIS 
PROGRAM WILL BE ASSEMBLED LATER. 


PRESS PF3 


PRESS PF3 

SELECT FOREGROUND (OPTION 4) 

SELECT SYSTEM ASSEMBLER 

ENTER ASSEMBLER INPUT: 
PROJECT : SAMPLE 

LIBRARY : USERID 

TYPE : ASM 

MEMBER : ASMTEST 

ASSEMBLER 


OPTIONS : LIST TEST RENT 


PRESS PF3 
PRESS PF3 
SELECT BATCH (OPTION 5) 


SELECT ASSEMBLER (OPTION 1) AND 


ACTION RESULT 


22. MEMBER SELECTION LIST 
23. BROWSE FILE MENU 

24. SPF PRIMARY GPTION MENU 
25. EDIT FILE MENU 


EDIT DATA DISPLAY OF 
SAMPLE .USERID .ASM( ASMTEST ) 


CURSOR IS POSITIONED TO THE 
STRING AND SEQUENCE NUMBER 
IS INTENSIFIED. 


THE RIGHT OF LINE IS ERASED 


THE LINE IS REPEATED 


THIS SETS PRINT MODE ON FOR 
AUTOMATIC SOURCE LISTINGS. 


GOOD LUCK 


MEMBER ASMTEST IS SAVED IN 
LIBRARY SAMPLE.USERID.ASM 
AND A LISTING OF THE MEMBER 
IS PLACED IN THE SPF LISTING 
FILE. THE EDIT FILE MENU 

IS DISPLAYED. 


SPF PRIMARY OPTION MENU 


FOREGROUND SELECTION MENU 


FOREGROUND ASSEMBLY MENU 


ASSEMBLER IS INVOKED. 
TERMINAL OUTPUT IS WRITTEN 
AT THE TOP OF A BLANK 
SCREEN. WHEN "MORE..." 
APPEARS, PRESS PA2 TO 
CONTINUE. TEXT FILE IS 
PLACED IN YOUR SPF LIBRARY 
SAMPLE.USERID.TEXT AS 
MEMBER ASMTEST, AND LISTING 
FILE (NAMED ASMTEST) IS 
WRITTEN ON YOUR A-DISK. 


FOREGROUND SELECTION MENU 
SPF PRIMARY OPTION MENU 
BATCH SELECTION MENU 


BATCH ASSEMBLY MENU 


ENTER JOB INFORMATION AS REQUIRED 


BY YOUR INSTALLATION. 





Figure 77. Sample problem scenario Cpart 2 of 3) 
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ACTION RESULT 


41. ENTER ASSEMBLER INPUT: 41. CONTROL COMMANDS FOR 
PROJECT : SAMPLE ASSEMBLING ASMTEST ARE 
LIBRARY : USERID GENERATED. THE BATCH 
TYPE : ASM SELECTION MENU IS 
MEMBER : ASMTEST REDISPLAYED. 

ASSEMBLER 
OPTIONS : TERM 
OBJ NODECK LIST 


42. PRESS PF3 THE JOB IS SUBMITTED TO 
THE CMS BATCH MACHINE. 
WHEN "HOLDING" APPEARS, 
PRESS PA2. PRIMARY OPTION 
MENU IS REDISPLAYED. 


AS THE JOB EXECUTES IN THE BATCH MACHINE, STATUS MESSAGES WILL BE 
RETURNED TO YOU. IN PARTICULAR, YOU WILL RECEIVE A MESSAGE WHEN THE 
ASSEMBLY IS COMPLETE INDICATING THAT THE TEXT AND LISTING FILES HAVE 
BEEN SPOOLED TO YOUR READER. DO NOT EXECUTE STEP 44 OF THIS SCENARIO 
UNTIL YOU HAVE RECEIVED THE COMPLETION MESSAGE. 


SELECT TUTORIAL (OPTION 7) START OF SPF TUTORIAL IS 
DISPLAYED. FOLLOW THE 
DIRECTIONS TO LEARN MORE 
ABOUT SPF. WHEN YOU ARE 
DONE, PRESS PF3 TO RETURN 
TO THE PRIMARY OPTION MENU. 


SELECT READER UTILITY (OPTION 3.7) READER UTILITY MENU 


SELECT INSERT (OPTION I) AND ENSURE READER UTILITY MENU IS 

THAT THE TARGET SPF LIBRARY FOR THE REDISPLAYED, SHOWING 

TEXT FILE IS SAMPLE .USERID. TEXT THAT THE FILE WAS MOVED 
INTO YOUR SPF LIBRARY; 
AND THAT THE LISTING IS 
NOW THE NEXT FILE IN 
YOUR READER. 


SELECT LOAD (OPTION L) AND ENTER: READER UTILITY MENU IS 

RENAME TO : ASMTEST2 LISTING. REDISPLAYED, SHOWING 
THAT THE LISTING WAS 
LOADED ONTO YOUR A-DISK, 
AND THAT YOUR READER IS 
NOW EMPTY. 


PRESS PF3 47. SPF PRIMARY OPTION MENU 


IF YOU HAVE FOLLOWED THIS SCENARIO, YOU SHOULD HAVE TWO LISTING FILES 
ON YOUR A-DISK, ONE NAMED ASMTEST (FROM THE FOREGROUND ASSEMBLY), AND 
THE OTHER NAMED ASMTEST2 (FROM THE BATCH ASSEMBLY). TRY BROWSE 
(OPTION 1) TO REVIEW THE LISTINGS, AND TRY EXPERIMENTING WITH OTHER 
SPF OPTIONS. WHEN YOU ARE DONE, RETURN TO THE PRIMARY OPTION MENU. 


(AT PRIMARY OPTION MENU) 48. SPF TERMINATION MENU 
PRESS PF3 


SELECT OPTION P FOR BOTH THE LOG 49. THE LOG AND LIST FILES 
AND LIST FILES, AND PRESS ENTER. ARE CLOSED AND RELEASED 
FOR PRINTING. 


YOU ARE NOW OUT OF SPF. TO EXIT 50. END OF SAMPLE 
FROM CMS TYPE "LOGOFF". 





Figure 78. Sample problem scenario (part 3 of 3) 
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APPENDIX B: SPF LIBRARY SPECIFICATION AND USAGE 


Before reading this appendix, please review the section entitled 
"SPF Libraries” on page 6 of this document. 


GUIDELINES FOR LIBRARY SPECIFICATION 


Each SPF library must be specified via the SPF file utility 
Coption 3.2) before it can be used. The name of the library along 
with the following information must be speci fied: 


SPF library attributes: 
Organization (S = set of files, M = MACLIB, T = TXTLIB) 
Record format CF = fixed, V = variable) 
Record length (1 to 32767 bytes) 


SPF library location: 
Owner's id Cblank for your user id) 
Device addr. (blank for '191') 


Link access mode for update: 
Mode letters CM, W, or MWD 


For organization S (set of files): 
Filetype. (blank for SPF-generated name) 


For organization M or T (CMACLIB or TXTLIB): 
Filename (blank for SPF-generated name) 


Naming Conventions 


An SPF library is always identified by a 3-component name Cproject 
name, library name, and type), where: 


e "project name” is the common identifier for all libraries 
belonging to the same programming project. 


e "library name" identifies the particular set of libraries 
Ci.e., the level within the library hierarchy). For a private 
library, the user id is an appropriate library name. 


e "type" identifies the type of information in the library. The 
SPF type qualifier need not conform to the standard CMS naming 
conventions, with one exception: If the library is to contain 
TEXT Cobject) modules, the SPF type qualifier must be TEXT 
regardless of whether the library organization is "S" (set of 
sequential files) or "T" CTXTLIB). 


Each component of the name may be up to eight alphameric charac~ 
ters, of which the first must be alphabetic. The same rule 
applies to member names. 


Library Organization 


The library organization must be one of the following: 


$ ~- The library will be maintained as a set of CMS sequential 
files, all with the same filetype. The CMS filenames will be 
the same as the SPF member names, and the CMS filetype may be 
aoe ee which uniquely identifies the set of files on the 
minidisk, 
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M ~ The Library will be maintained as a CMS file with a filetype 
of MACLIB. The CMS filename may be anything which uniquely 
identifies the MACLIB on the minidisk. The member names in 
the MACLIB will be the same as the SPF member names. 


T ~- The library will be maintained as a CMS file with a filetype 
of TXTLIB. The CMS filename may be anything which uniquely 
identifies the TXTLIB on the minidisk. The member names in 
the TXTLIB will be the same as the SPF member names. 


Libraries containing documentation to be processed by the 
SCRIPT/VS utility Coption 3.9) must have an organization of "5S", 
but they need not have an SPF type qualifier of SCRIPT nor a CMS 
filetype of SCRIPT. 


Libraries containing TEXT Cobject) modules must have an organiza~ 
tion of "S" or "T", and the SPF type qualifier must be TEXT. (For 
organization "5" the CMS filetype need not be TEXT.) 


Any other libraries may have an organization of "S" or "M". There 
are no restrictions on the SPF type qualifier, nor the CMS 
filetype (for organization "5™). 


Following are additional suggestions for specifying library 
organization: 


° Libraries which are frequently updated Cespecially the lowest 
level libraries in a project hierarchy) should be assigned an 
organization of "SS". This will eliminate the need for com- 
presses. 


° As a performance consideration, it may be desirable to assign 
higher level libraries an organization of "M" or "T" if one or 
more of the following applies: 


- The library has many members. 
- The library is infrequently updated. 


om The library contains members which are included or copied 
by other members during a compile or assembly. See "Fore- 
ground/Batch Processing", which follows, for a discussion 
of included members. 


Record Format and Length 


Libraries which have an organization of "M" or "T"™ must have a 
record format of "F™ (fixed), and a orecord length of 80. 
Libraries which have an organization of "S" may have a record for- 
mat of either "F" or "V" (variable), and a record length from 1 to 
32767. Note, however, that the SPF editor will not process any 
data with a record length less than 10. 


For format "F", the record length indicates the exact length of 

each record in the library. For format "V", the record length 

heat the maximum allowable length of any record in the 
ibrary. 


Library Location 


Each SPF Library must be wholly contained on one minidisk, which 
is specified via owner's user id and virtual device address. 


More than one SPF library may be assigned to the same minidisk, 
and SPF libraries may co-reside on the same minidisk with other 
CMS files Cwhich are not SPF libraries). Be careful, however, to 
guard against conflicting CMS filetypes or filenames (see "Unique 
Identifier” and "Foreground/Batch Processing" which follow). 
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Following are additional suggestions for specifying library 
location: 


® Typically, the lowest level libraries in a project hierarchy 
are private libraries and should reside on a minidisk which is 
owned by the user of the library Cand should have an organiza~ 
tion of "S™). 


° Higher level libraries in the project hierarchy are typically 
common libraries which are accessed for reading by anyone on 
the project, but are controlled Cupdated) by one designated 
individual. It is a good idea for these libraries to be on 
minidisks which are owned by the person who will be updating 
them, and which are write protected Ci.e., no update password 
or an update password known only to the owner). 


° If higher level libraries are to be protected against unau~ 
thorized reading by anyone outside the project, they should 
reside on minidisks which all have the same read password. 
The reason for this is that SPF menus provide a single read 
password which applies to all libraries in the concatenation 
sequence. 


Link Access Mode 


The link access mode for update must be one of the following: 


W - Link will be successful only if no other user is currently 
accessing the minidisk Cin either read or write mode). 


M ~- Link will be succéssful if no other user is currently 
accessing the minidisk in write mode. 


MW - Link will be successful in all cases. 


If the library is to reside on a user's A-disk (which SPF assumes 
has a virtual device address of 191), do not specify "MW" for the 
link access mode. SPF will not protect against multiple write 
accessing to virtual device 191. 


Note: As a general rule, multiple-write passwords should not be 
assigned to a user's A-disk. The absence of a such a password 
will prevent any attempt to Link to the disk in "MN" mode. 





For SPF libraries which are not on a user's A-disk, a link access 
mode of "MW" may be specified provided that all access to that 
minidisk (for SPF libraries or any other files) is through SPF. 

If some accesses to the minidisk will be done outside SPF, a link 
access mode of "M" or "W" should be specified. 


SPF provides appropriate protection to guard against destructive 
contention in multiple read/write accessing of SPF libraries and 
CMS files, except as noted above for a user's A-disk. 


Unique Identifier 


The CMS filetype (for organization "S") or CMS filename (for 
organization "M" or "T") must uniquely identify which files on a 
minidisk belong to the SPF library. The recommended procedure is 
to let SPF assign a unique identifier by leaving the filetype and 
filename fields blank on the "specify" menu. The SPF-assigned 
identifier will be of the form: — 


SPFnnnne 


where "nnnn"® is a four digit number, and "c" is S, M, or T. 
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Keep in mind the following points: 


° For an SPF library, the CMS filetype Corganization "S") or 
filename Corganization "M" or "T") need not conform to any CMS 
naming convention. 


° Since the SPF library can be referenced by project, library, 
and type on any menu, the CMS filetype or filename is general~ 
ly transparent to the user. 


If a filetype or filename is entered on the “specify” menu, it is 
the user's responsibility to ensure that the identifier is unique 
for the minidisk. If sequential files already exist on the mini-~ 
disk with the specified filetype, or if MACLIBs or TXTLIBs already 
exist on the minidisk with the specified filename, the existing 
files will automatically be included in the SPF library. This may 
or may not be desired. In any case, the SPF file utility will 
display a warning on the "confirm specify" menu that existing 
files will be included in the SPF library. 


PROCESSING CONSIDERATIONS 


SPF maintains information on all SPF libraries specified to the VM 
system. Whenever a user enters project, library, and type on a 
menu, SPF determines the minidisk on which the library is located 
Cuser id and virtual device address), and then performs the neces- 
sary LINK and ACCESS commands on behalf of the user. 


For the LINK command, SPF uses a link access mode of "RR" (for a 
read-only function such as browse), or whatever mode was entered 
when the library was specified (for an update function such as 
edit). The link access mode of "RR" alows the LINK to be success~ 
ful even if another user currently has the disk accessed in read 
or write status. 


For the ACCESS command, SPF selects the first available mode let- 
ter Cin the collating sequence) which is not currently in use by 
the user who is accessing the library. 


The minidisk containing the SPF library is automatically detached 
Cand the mode letter is released) when the user finishes the 
selected SPF function. 


Under certain circumstances, the automatic LINK and ACCESS can 
cause a temporary alteration to the user's normal search sequence 
for CMS files. Example: 


Suppose the user has explicitly accessed two minidisks, using 
mode letters A and C. Subsequently, the user specifies an SPF 
library on some menu (such as browse). SPF selects mode let- 
ter B te access the library. The user then enters split 
screen mode (without leaving browse), and specifies a CMS 
filename and filetype on another menu. If the specified file © 
exists on both the B and C disks (but not on A), the B copy 
will be found first. The user may not be expecting this, 
since he did not explicitly access the B-disk. 


Foreground/Batch Processing 
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\ 


The SPF foreground and batch processing options Coptions 4 and 5) 
automatically perform the following operations if an SPF library 
{or concatenated sequence of libraries) is specified: 


° The library Cor sequence of libraries) is scanned to find the 
specified member, and the member is copied to a temporary 
file, if required, with a CMS filetype which is acceptable to 
the particular processing program (Ce.g., ASSEMBLE, COBOL, 
PLI)}. The CMS filename for the temporary file will be the 
same as the SPF member name. 
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® For any libraries in the SPF concatenation sequence Cinclud- 
ing the first, or only, library) which are not organization 
"™™", temporary MACLIBs are created and all members are copied 
from each SPF library to the corresponding MACLIB. A GLOBAL 
command is then executed to set up the MACLIB concatenation 
sequence. This allows members to be included (via INCLUDE or 
COPY statements) from the concatenated sequence of Libraries 
during the compilation or assembly. 


e For foreground processing, the temporary file and temporary 
MACLIBs will reside on the the user's A-disk. For batch, they 
will reside on the batch machine's A-disk. In either case, 
the temporary files are erased once the compilation or assem- 
bly has completed. 


® The TEXT Cobject) module produced by the compilation or 
assembly is placed in an SPF library with the following name: 


Project - same as project name of source library 
Library ~- same as first library in concatenation sequence 
Type ~ TEXT 


For foreground processing, the TEXT module is automatically 
placed in the SPF TEXT library. For batch processing, . the 
user may invoke the SPF reader utility Coption 3.7) to cause 
the TEXT module to be inserted into the SPF TEXT library. 


ibrary Statistic 


Whenever an SPF library is specified, a separate file is created 
on the same minidisk to contain the library statistics. This isa 
sequential file with a CMS filetype of SPFSTATS and a filename 
which is the same as the unique identifier of the SPF library. 


Generally, the SPFSTATS file is transparent to the user, since the 
statistics are automatically created and maintained by the SPF 
editor Cif STATS mode is on), and automatically displayed on mem- 
ber selection lists and printed on "index™ Listings. 


Users should not attempt to edit or otherwise modify the SPFSTATS 
files. If an SPFSTATS file is modified or destroyed, however, only 
the statistics will be lost; the contents of the SPF library mem- 
bers will still be intact. 


If members of the SPF library are modified outside of SPF (via 
some other editor) or are specified on an SPF menu via CMS file id 
Crather than project, library, and type), the statistics will not 
be properly updated, but the information in the member will still 
be acceptable to SPF. 


‘Note: If a user deletes all lines in a member of an SPF library 
Cusing the SPF editor) and then saves the member, the statistics 
will show that the member still exists but has a length of zero. 
However, if the library is specified for a foreground or batch 
compilation or assembly, the member will not be found by the proc~ 
essing program. The proper way to delete a member Cincluding its 
statistics) is to use the library utility Coption 3.1). 
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Under user option, the SPF editor will automatically generate a 
source listing upon completion of editing Cif PRINT mode is on). 
Source listings may also be obtained via the “print™ option of the 
SPF library utility Coption 3.1) and the move/copy utility 
Coption 3.3). 


A sample source listing is shown in Figure 79. 


For an SPF library, information at the top of the page includes 
project, library, type, member, current version, and modification 
level. The member name is also repeated at the right for ease of 
filing. For a CMS file, the file id Cand member name for a MACLIB 
or TXTLIB) are indicated. The header lines also include user id, 
date and time that the listing was produced, and page number. 


A column positioning line is printed following the heading and 
preceding the actual data. The “start column" is printed to the 
left of each Line, indicating the position of the first non-blank 
character in each line. For SPF library members with statistics, 
asterisks may be printed to the right of each line, as follows: 


° If the modification flag Ccolumns 79-80) in the line is 00, no 
asterisks are printed. 


° If the modification flag is non-zero but differs from the cur- 
rent modification level of the member, a single asterisk () 
is printed. 


e If the modification flag is non-zero and has the same value as 
the current modification level of the member, two asterisks 
(**) are printed. 


The asterisks allow the listing to be scanned quickly for lines 
that were added or changed since the version was created (%) and 
for lines that were added or changed during the last update (x). 


SPF provides index listings, upon user request, via the "index" 
option of the Library utility Coption 3.1). A sample index list- 
ing for an SPF source library is shown in Figure 80. The heading 
information includes: project, library, and type, date and time 
that the listing was produced, and page number. This is followed 
by general information about the Library. Following this, the 
member name and statistics are printed for each member, arranged 
in alphabetical order. 


Finally, a sample SPF log listing is shown in Figure 81. The log 
contains a message for each significant user action, such as sav- 
ing edited data» moving members from one library to another, or 
submitting a batch job. 
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*) XIGNAddv 


SLVWYOA ONTISI1 AdS 


GT 


PROJECT: SPFDEMO MEMBER: COINS DATE: 
LIBRARY: MYLIB LEVEL: 01.04 TIME: 
TYPE: PL USERID: ORR PAGE: 
START 
Ot) nt ne ae a ar ee, eae Serene, ate 


COINS: 
PROCEDURE OPTIONS (MAIN); 

DECLARE 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1); 
HALVES FIXED BINARY (31), 
QUARTERS FIXED BINARY (31), 
DINES FIXED BINARY (31), 
NICKELS FIXED BINARY (31), 
SYSPRINT FILE STREAM OUTPUT PRINT3 

DO HALVES = 100 TO 0 BY -50; 


DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY -10; 
NICKELS = 100 ~ HALVES - QUARTERS ~- DIMES; 


79/05/18 
17:22 
Ol OF OL 


00010001 
00620000 
00030000 
00040000 
60050000 
00060003 
00070000 
00080004 
00090000 
00100000 
00110000 
00120000 
00130000 


PUT FILEC(SYSPRINT) DATACCOUNT »HALVES,» QUARTERS ,»DIMES,NICKELS ) 300140000 


COUNT = COUNT + 1; 
END; 
END; 
END; 


2 
& 
6 
8 
8 
& 
& 
8 
8 
6 
8 DO QUARTERS = (100 ~ HALVES) TO 0 BY -25; 
16 
le 
le 
12 
10 
& 
6 
4 END COINS; 


Figure 79. Sample source listing 


00150000 
00160000 
00170000 
00180000 
00190001 


MoD 
FLAGS 


HH 


COINS 


2ST 


IVWANYW ADNAMSASY WVESONd SNI7ddS 


PROJECT: SPFDEMO 
LIBRARY: MYLIB 
TYPE: PLI 


ATTRIBUTE DATA: 
ORGANIZATION: 
RECORD FORNAT: 
RECORD LENGTH: 


MEMBER VERS.MOD 
NAME LEVEL 


ACCOUNT 01.00 
AccTl 01.01 
ACCT2 61.00 
COINS 61.04 
COMPX 61.00 
COMPY 01.01 
DCLS 01.00 
LISTOUT 01.02 
MAIN 01.00 
TESTDIR 01.62 


MAXIMUMS : 01.04 


TOTALS: 


END OF MEMBER LIST 


Figure 80. Sample index listing ~ source library 


LOCATION DATA: 
OWNER'S ID: 
DEVICE ADDR: 


CREATION 
DATE 


79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79701709 
79/04/23 


79704724 


DATE AND TIME 
LAST MODIFIED 


79701709 
79704723 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79701709 
79/05/06 


79705706 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:60 
17:08 
17:04 


17304 


LINK ACCESS 
MODE FOR UPDATE: MW 


CURRENT 


NO « 


LINES 


INITIAL 


NO. 


LINES 


MODIFIED 
NO. LINES 


Oo we fe 
—- @& 


DATE: 79/05/08 
TIME: 17:22 
PAGE: 001 


NUMBER OF MEMBERS: 12 


USER 
ID 


KLEIN 
KLEIN 
ORR 
ORR 
ORR 
ORR 
MOSTON 
KLEIN 
MOSTON 
MOSTON 





2) XIGN3ddV¥ 


SLYWAOd ONILSTI1 ad$ 


£GT 


TIME 


17:11 
17:12 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:14 
17:15 
17:15 
“17315 
17:16 
17:17 
17:17 
17:17 
17:19 
17:19 
17:20 


Figure 81. 


%*% SPF TRANSACTION LOG %x%% USERID: JOSLIN DATE: 79/05/29 


START OF SPF SESSION LOG $5 ------ 23 nn een nn ee re ne re rn re ren rn ern nnn re nee ee 

UTILITY - SPECIFY ~ LIBRARY 'SPFDEMO.NEWLIB.PLI" CREATED ON JOSLIN 191. 
UTILITY - MOVE/COPY~ SPFDEMO.MYLIB.PLIC ACCOUNT) COPIED 

TO SPFDEMO.NEWLIB.PLI( ACCTXX) 
UTILITY - MOVE/COPY~ SPFDEMO.MYLI8.PLICACCT1) COPIED 

TO SPFDEMO.NEWLIB.PLICACCTYY ) 
UTILITY - MOVE/COPY- SPFDEMO.MYLIB.PLICACCT2) COPIED 

TG SPFDEMO.NEWLIB.PLI(ACCTZZ) 
UTILITY - MOVE/COPY- SPFDEMO.MYLIB.PLI(COINS) COPIED 

TO SPFDEMO.NEWLIB.PLICCOINS } 
EDIT ~ SAVE - SPFDEMO.NENLIB.PLI(COINS) - MEMBER SAVED 
EDIT - CREATE -~- SPFDEMO.NEWLIB.PLICACCTNEW) - MEMBER CREATED 
EDIT ~ SAVE ~ SPFDEMO.NENLIB.PLICACCTXX) - MEMBER SAVED 
EDIT ~- SAVE - SPFDEMO.NENLIB.PLICACCTYY) - MEMBER SAVED 
EDIT - SAVE - SPFDEMO.NEWLIB.PLICACCTZZ) ~ MEMBER SAVED 
UTILITY - DELETE - SPFDEMO.NEWLIB.PLICACCTZZ) DELETED 
CMS ~ COMMAND ~ QR 
UTILITY - SPECIFY ~ LIBRARY 'SPFDEMO.NEWNLIB.TEXT’ CREATED ON JOSLIN 191. 
BATCH - JOBSTEP - PLI OPT COMPILE -- TO SPFDEMO.NEWLIB.TEXT(COINS) 
BATCH - JOB ~- JOSLIN UI01 SUBMITTED. 

END OF SPF SESSION LOG 85 ----~----~--~-~- Sm a tr yu er mee et ey se ep 


Sample log listing 


PAGE: 1 


APPENDIX D: 


SUMMARY OF SPF COMMANDS 


MEMBER LIST COMMANDS 


The following commands may be entered in the command input field 
Cline 2 of the logical screen) on member list displays. 


LOCATE Causes direct scrolling to the specified member name (may 


SELECT 


be entered on any member list display). 


Causes the specified member name to be selected for 
browse, edit, or SCRIPT/VS utility Cinvalid on other 
utility member list displays). Allows selection of a mem- 
ber which is not in the list. 


On member list displays, the following one-character commands may 
be entered at the beginning of a line, ahead of the member name. 


§ (select) Causes the member to be selected for browse, edit, 


move/copy, reset, or SCRIPT/VS utility Cinvalid under 
the library utility). 


P Cprint) Causes the member to be printed (valid only under the 


library utility). 


R (rename) Causes the member to be renamed (valid only under the 


library utility). The new name must be entered to the 
right of the member name. 


D (delete) Causes the member to be deleted (valid only under the 


library utility). 


B (browse) Causes the member to be browsed (valid only under the 


library utility). 


BROWSE COMMANDS 
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The following commands may be entered in the command input field 
Cline 2 of the logical screen) under browse, and also under the 
SCRIPT/VS utility and the "display" option of the SPF project 


utility. 


LOCATE 


o XKKXKX 


cOLs 


RESET 
FIND 


CAPS 


HEX | 


Causes direct scrolling to the specified relative line 
number or label. 


Establishes a label (SPF internal symbol) which is 
equated to the top line on the screen. It can then be 
used with the LOCATE command to cause scrolling directly 
to that line. 


Causes display of a line that identifies column 
positions. 


Removes the column identification line from display. 


Causes the data to be scanned for one or all occurrences 
of a character string. The cursor is repositioned to the 
beginning of the first occurrence, if it is found. 


Causes character strings, entered as part of the FIND 
command, to be converted to upper case. CAPS OFF causes 
character strings to be left as-is. 


Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format. 
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EDIT LINE COMMANDS 


Under edit, 


line commands may be entered at the beginning of a 


line by overtyping the line number. 


COLS 


I Cinsert) 
D (delete) 
R Crepeat) 


M (move) 
CG Ccopy) 
A (after) 


B (before) 
MASK 

< Cleft) 

> Cright) 
C Cleft) 

» Cright) 
BOUNDS 

X Cexclude) 
S Cshow) 

F (first) 
L Clast) 
TABS 


TE 
TS 


TF 


0 Coverlay) 


Causes display of a line that identifies column 
positions. 


Causes a new line to be inserted after this line. 
Causes the line to be deleted. 


Causes the line to be repeated and the duplicate copy 
to be inserted after this line. 


Identifies a line to be moved. 
Identifies a line to be copied. 


Identifies the line after which copied or moved lines 
are to be inserted. 


Identifies the line before which copied or moved 
lines are to be inserted. 


Causes display of the insert mask, to allow pre-entry 
of data on inserted lines. 


foe the contents of the line to be "data™ shifted 
eft. 


Baer the contents of the line to be "data" shifted 
right. 


Causes the contents of the line to be "column" 
shifted left. 


Causes the contents of the line to be "column" 
shifted right. 


Causes display of the column boundary line, to allow 
redefinition of boundary positions. 


Causes the line to be excluded from display. May also 
be a to limit the scope of the FIND and CHANGE com- 
mands. 


Causes an excluded line to be redisplayed. 


Causes the first line in a block of excluded lines to 
be redisplayed. 


Causes the last line in a block of excluded lines to 
be redisplayed. 


Causes display of the tab line, to allow definition 
of hardware, software, and logical tab positions. 


Facilitates bulk text entry by allowing the user to 
type continuously without regard to the line number 
area. 


Causes splitting of a line into two lines at the 
designated cursor position to facilitate the | 
insertion. of new material in existing text. 


Causes reflowing of a paragraph of text from the 
cursor position to the end of the paragraph. 


Causes data to be copied or moved “over” the existing 
data on one or more lines. Blank characters in the 
receiving line€s) are overlayed with corresponding 
characters in the source line(s). 
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The following line commands may be entered with double characters 
to indicate the beginning and end of a block of lines. 


Block delete << =~ Block "data" shift left 
Block repeat >> - Block "data”™ shift right | 
Block move CC = Block “column" shift left 
Block copy >> ~- Block "column" shift right 
Block exclude 00 - Block overlay 


The following line commands may incorporate a number (n) consist~ 
ing of one or more digits. 


In 
Dn 
Rn 
RRn 
Mn 
Cn 
An 


Bn 


Insert n lines following this line 

Delete n lines starting at this line 

Repeat this line n times 

Repeat block of lines n times 

Move n lines starting at this line 

Copy n lines starting at this line 

Insert n copies of the moved/copied line(s) 
after this line 

Insert n copies of the moved/copied line(s) 
before this line 

Data-shift line left n positions 

Data~shift block of lines left n positions 
Data-shift line right n positions 

Data-shift block of lines right n positions 
Column-shift line left n positions 
Column-shift block of lines left n positions 
Column-shift line right n positions 
Column~shift block of lines right n positions 
Exclude n lines starting at this line 

Show n lines in a block of excluded lines 

Show first n lines in a block of excluded Lines 
Show last n lines in a block of excluded lines 
Insert n text entry lines following this line 
Insert n new lines between the split lines 
Flow text from left bound to column position n 
Overlay n lines 


If a number is not entered, the default is 1 except for: 


° The shift commands (which default to 2 column positions) 


° The TE command (defaults to the number of lines remaining on 
the screen) 


° The TF command (defaults to the specified column boundaries) 


EDIT PRIMARY COMMANDS 


Under edit, the following commands may be entered in the command 
input field Cline 2 of the logical screen). 


LOCATE 
NUMBER 


RENUM 
UNNUM 


AUTONUM 


STATS 


Causes direct scrolling to the specified line number. 


Causes sequence numbers to be generated for any new 
lines that are created via insert, repeat, or copy. NUM~ 
BER OFF causes lines to be generated without numbers. 


Renumbers each line and turns on NUMBER mode. 


Causes sequence numbers to be set to blanks and turns off 
NUMBER mode. 


If edit is in NUMBER mode, causes sequence numbers to be 
automatically renumbered whenever a save is done. 
AUTONUM OFF bypasses automatic renumbering at save time. 


Causes SPF statistics to be generated or updated 
whenever a member of an SPF library is saved, created, or 
replaced. STATS OFF causes members to be stored without 
statistics. 
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PRINT 


RECOVERY 


RESET 
SUBMIT 
SAVE 


CANCEL 
FIND 


CHANGE 


COPY 


MOVE 


CREATE 


REPLACE 


NULLS 


TABS 


PROFILE 


HEX 


CAPS 


Causes a source listing of the edited data to be 
automatically recorded in the SPF list file whenever 
data is saved by pressing the End PF key. PRINT OFF 
bypasses automatic source listings. 


Enables the SPF edit recovery function. If there is a 
subsequent system failure, the user can recover the SPF 
edit session up to the point of failure. RECOVERY OFF 
disables edit recovery. 


Causes a general resetting of intensified messages, 
incomplete line commands, and special lines. 


Causes the data being edited to be submitted to the job 
stream of another VM machine for execution. 


Causes the data to be stored back into the edit file and 
editing to continue. 


Causes editing to be terminated without saving the data. 


Causes the data to be scanned for one or all occurrences 
of a character string. The cursor is repositioned to the 
beginning of tha first occurrence, if it is found. 


Causes one or all occurrences of a character string to be 
replaced with a second string. The cursor is reposi~ 
bd et to the end of the first occurrence, if it is 
ound. 


Causes data to be copied from another source and 
inserted at a point indicated with the A Cafter) or B 
(before) line command. The other source can be a member 
of an SPF library or MACLIB, or a sequential CMS file. 


Same as COPY, except that the other source is deleted 
after the copy operation. 


Causes a line or block of lines to be stored in any SPF 
library or MACLIB as a new member. The line(€s) to be 
stored are designated with the C or CC (copy), or M or MM 
(move) line commands. 


Same as CREATE, except that it allows an existing member 
or a CMS sequential file to be replaced. 


Replaces trailing blanks on the screen with null 
characters. NULL OFF causes trailing blanks to be sent 
to the screen as blanks. 


Enables the use of "hardware”™ or "logical”™ tabs at user 
defined positions (specified via the tabs line command). 
TABS OFF disables the use of "hardware" or "logical"™ 
tabs. 


Causes the display of the current setting of edit modes 
CNUMBER, AUTONUM, STATS, PRINT, CAPS, NULLS, TABS, HEX, 
and RECOVERY). Also displays the MASK, TABS, and BOUNDS 
Ff ccicee e they have settings other than their 
efaults. 


Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format. 


Causes alphabetic data entered from the terminal to be 
translated to upper case, including FIND and CHANGE 
strings. CAPS OFF causes alphabetic data to be left 
as-is. 
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APPENDIX E: SPF COMMAND SYNTAX - QUICK REFERENCE SUMMARY 


MEMBER LIST COMMANDS 


Primary Commands: 
LOCATE member-name 


SELECT member-name 


BROWSE COMMANDS 


(select) 


Cprint) 

(rename) 
(delete) 
Cbrowse) 


GUAT W 


LOCATE line-number/label 


+ XXXXX 
COLS 
RESET 


FIND string [CNEXT/ALL/FIRST/LAST/PREV] 


[CCHARS/PREFIX/SUFFIX/WORD] 
[col-1 [col-2]] 


CAPS [ON/OFF] 
HEX CON/OFF] [VERT/DATA] 


EDIT LINE COMMANDS 


asic Commands: 


Line Selection Commands: 


- except opt. 3.1 


option 3.1 only 
option 3.1 only 
option 3.1 only 
option 3.1 only 


Advanced Features: 


cOLsS MASK 
I, In Cinsert) <, <n, <<, <<n (data left) 
' D, Dn, DD (delete) >, >n, >>, >>n Cdata right) 
R, Rn, RR, RRn Crepeat) C, Cn, CC, COn Cools left) 
M, Mn, MM - (move) ¥, Jnr 3, JIN Ceols right) 
C, Cn, CC Ccopy) BOUNDS 
A, An Cafter) X, Xn» XX Cexclude) 
B, Bn (before) S, Sn (show) 
F, Fn (first) 
L, Ln Clast) 
TABS 
Text Pr ration Features: 
TE, TEn (text entry) 
TS, TSn (text split) 
TF, TFn (text flow) 
0, On, OO Coverlay) 
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EDIT PRIMARY COMMANDS 


General Commands: 

LOCATE line-number 

NUMBER [ON/OFF] [STD] [COBOL] 
RENUM [STD] [COBOL] 
UNNUM 

AUTONUM [ON/OFF 


Advanced Features: 


COPY [member-name] 
MOVE Umember-name] 


CREATE [Emember~-name]l 
REPLACE Cmember-name] 


NULLS [ON/OFF] CALL] 


TABS [ON/OFF] 
Ctab-char] CALLJ 


STATS CON/OFF] 


PROFILE [Enamel] Enumber] 


PRINT CON/OFF] 
HEX LCON/OFF] 


RECOVERY CON/OFF] CVERT/DATA]I 

RESET 

SUBMIT machine-id 

SAVE Text Preparation Features: 
CANCEL CAPS CON/OFF] 


Find and Change Commands: 

FIND string-1 (UNEXT/ALL/FIRST/LAST/PREVI 
[CHARS/PREFIX/SUFFIX/WORD] 
[X/NX] 
[col-1 [(col-2]] 


CHANGE string-1l string-2 [NEXT/ALL/FIRST/LAST/PREV] 
[CHARS/PREFIX/SUFFIX/WORD] 


Ccol-1 [col-2]] 


FIND/CHANGE STRINGS (BROWSE AND EDIT) 


Character String Format: 


Simple string: ceccce Cno embedded blanks or commas) 
Delimited string: Yeccce’ or "ccecc" 

Hex string: X*hhhh' or 'hhhh'X 

Text string: T'eccc’ or 'cecc'T 

Picture string: P'ssss’ or "ssss'P 

Previous string: % Csingle asterisk) 


Picture Strings - Special Characters: 


P’=' - any character (don't care) 

P'=-* - any non-blank character 

P'.’ - any non-displayable (invalid) character 

P'#* - any numeric character (0-9) 

P’-' - any non-numeric character 

P'a" - any alphabetic character Cupper or lower case) 
P'<* - any lower case alphabetic character 

P'>" - any upper case alphabetic character 

P'S’ - any special character (not alpha or numeric) 


APPENDIX E: SPF COMMAND SYNTAX ~- QUICK REFERENCE SUMMARY 


APPENDIX F: SPF/TSO - SPF/CMS DIFFERENCES 


SPF/CMS is functionally equivalent to the SPF/TSO program pro- 
duct, 5740-XT8, Version 2.2. The two products are fully compat- 
ible in display formats and operation, except for those features 
which are explicitly oriented to the VS2/TSO or VM/CMS environ- 
ment. The following is a list of those differences. 


° On the primary option menu, option 6 is: 


SPF/TSO: Enter TSO Command or CLIST 
SPF/CMS: Enter CMS Command or EXEC 


° Menus and tutorials which refer to "data sets" in SPF/TSO 
refer to "files" in SPF/CMS. The first part of the data set 
Cfile) menus allows specification of an SPF library. The for- 
mat 1s identical in SPF/TSO and SPF/CMS, namely: 


SPF LIBRARY: 
PROJECT 
LIBRARY 


TYPE 
MEMBER 


uuu 
VVVY 


(BLANK FOR MEMBER SELECTION LIST} 





The second part of the data set (file) menus differs as fol- 
lows. For SPF/TSO: 


OTHER PARTITIONED OR SEQUENTIAL DATASET: 
DATASET NAME 
VOLUME SERIAL (IF NOT CATALOGED) 





For SPF/CMS: 


CMS FILE: 
FILE ID : 
MEMBER (FOR MACLIB OR TXTLIB} 


IF NOT LINKED, SPECIFY: 
ORNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 





The third part of the data set (file) menus contains an (0S) 
password field for SPF/TSO. For SPF/CMS; this part of the 
menu may contain a read password field, an update password 
field, or both, depending on the type of function. In 
SPF/TSO, passwords pertain to data sets; in SPF/CMS, they 
pertain to minidisks. 


° Implementation of SPF libraries in SPF/TSO is accomplished 
uSing partitioned data sets, while SPF/CMS uses sequential 
CMS files and/or MACLIBs and TXTLIBs Cunder user option). 


e SPF/TSO supports printing on either: 


System printer (via submission of a background job) 
328x printer (via interface to DSPRINT command) 


SPF/CMS supports printing via the CMS PRINT command. The out~- 
put may be directed to the system printer or spooled to anoth- 
er user Cor machine), which may be at a remote node in the 
network. SPF/CMS does not support printing on a 328x printer. 


° Specification of “job statement information" occurs in 
SPF/TSO on the background selection menu and all menus per~- 
taining to hardcopy output. SPF/CMS provides job information 
on the batch selection menu only. All other output is accom- 
plished with the CMS PRINT, PUNCH, or DISK DUMP commands, 
rather than via job submission. 
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Additionally, job statement information syntax and keywords 
are different, reflecting differences between CMS batch job 
streams and VS2 JCL. 


Differences in foreground processing Coption 4) and back- 
ground (batch) processing Coption 5) are as follows: 


SPF/TSO: Compiled/assembled output Cobject module) goes into 
an SPF library whose "type" is OBJ. Link edit out~ 
put Cload module) goes into an SPF library whose 
"type" is LOAD. 


SPF/CMS: Compiled/assembled output Cobject module) goes into 
an SPF library whose "type"” is TEXT. Linkage edit~- 
Uehse not supported, but the LOAD command is sup- 
ported. 


Option 3.2 (dataset/file utility). The following suboptions 
of this utility in SPF/TSO: 


A ~- Allocate new data set 
C ~ Catalog data set 
U - Uncatalog data set 


are replaced in SPF/CMS with: 


S - Specify new SPF library 
U - Unspecify SPF library 


There is no need for an "allocate file” capability under 
SPF/CMS, since: space allocation is handled automatically by 
VM/CMS. There is, however, a need to pre-specify SPF library 
identifiers and file characteristics to SPF/CMS. 


Option 3.4%. In SPF/TSO this is the catalog management utili- 
ty. In SPF/CMS it is replaced with the project utility, which 
provides a similar function for SPF libraries. 


Option 3.6. In SPF/TSO this is the hardcopy utility. In 
SPF/CMS it is replaced with the spool utility, which provides 
similar functions for printing and punching, and also allows 
spooling to another user Cor machine), which may be at a 
remote node in the network. 


Option 3.7. In SPF/TSO this is the list VTOC utility, which 
has no equivalent in SPF/CMS. It is replaced with a new 
SPF/CMS function, the reader utility. 


Option 3.8. In SPF/TSO this is the outlist utility, which has 


no equivalent in SPF/CMS. It is replaced with a new SPF/CMS 
function, the retrieve utility. 
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Access (see Link Access Mode) 
After "A" Line Command 54 
Attention PA Key 10 

AUTONUM Command = 59 

Autonum Mode 45 


Batch (also, see Job) 
Batch Processing 134, 148 
Insert Batch Output in SPF Library 120 
Before "B" Line Command 
BOUNDS Line Command 76 
Browse 30 
Browse Member 104 
Browse Member "B™ Command 24, 104 


CANCEL Command 62 

CAPS Command (Browse) 38 
CAPS Command (Edit) 93 
Caps Mode CEdit) 45 
Caution Message (Edit) 46 


Change 
CHANGE Command 64, 67 
Repeat Change PF Key 11, 65 
CMS Command Entry 138 
CMS File id 8, 106, 147 
COLS Command (Browse) 33 
COLS Line Command CEdit) 49 
Compress MACLIB 103 
Console 16, 20, 27 ; 
Concatenation of SPF Libraries 6, 8» 40, 131, 136, 148 


Copy 
Copy File or Member (Move/Copy Utility) 109 
COPY Command 82 
Copy "C"™ Line Command 54 
CREATE Command 84 
Create/Update SPF Statistics 115 
Cursor 
Cursor Pasitioning in Edit 56 
Move Cursor PF Key 11 


Data Display Format 2 


Delete 
Delete "D"™ Line Command 50 
Delete Member 104 
Delete Member "D" Command 24, 104 
Delete (Purge) Reader File 120 
Delete SPF Library or File 107 
Delete SPF Statistics 115 
Disk Dump File 117 
Display 
Display Document CSCRIPT/VS) 126 
Display Member Selection List 8, 23, 104 
Display Project Entries 113 . 
Display SPF Library or File Information 107 
SPF Display Formats 
Draft Document Options CSCRIPT/VS) 126 


Edit 40 
Edit Modes and Profiles 45 
End PF Key Il 
Exclude "X" Line Command 78 
(also, see Show Excluded Lines) 
EXEC Processing 138 


File - CMS File id 8, 106, 147 
File Utility 
Delete SPF Library or File 107 
Display SPF Library or File Information 107 
Rename SPF Library or File 107 
Specify New SPF Library 106 
Unspecify SPF Library 106 
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Braet Document Options (SCRIPT/VS) 127 
in 
FIND Command (Browse) 34, 35 
FIND Command CEdit) 64, 67 
Repeat Find PF Key (Browse) 11, 34 
Repeat Find PF Key CEdit) 11, 65 
First "F™ Line Command 78 
Foreground Processing 130, 148 


Help 
Help PF Key 11 
Help Information 14 
HEX Command (Browse) 38 
HEX Command CEdit) 91 
Hex Mode CEdit2 45 
Hex String 35, 67 


Indentation 73 : 

(also, see Shift Line) 
Insert "I" Line Command 5 
Insert Batch Output in SPF Library 120 
Invocation of SPF 19 


Job 
Job Submission for CMS Batch Processing 134 
Job Submission from Edit 62 
Job Submission from Spool Utility 117 


Label (Browse) 32 
Language Processors 17, 130, 134 
Last "L® Line Command 
Libraries 
Library Name 6, 145 
Library Statistics 15, 115, 149 
SPF Library Organization 6, 106, 123, 145 
Library Utility 
Browse Member 104 
Compress MACLIB 103 
Delete Member 104 
Display Member List 104 
Print Index Listing 103, 152 
Print Member 104 
Print SPF Library or File 104 
Rename Member 104 
Line Number 32, 57 
Link Access Mode 9, 106, 147 
List File 16, 20, 27 
Listing Formats 150 
Load Reader File 120, 121 
LOCATE Command (Browse) 32 
LOCATE Command CEdit) 57 
LOCATE Command (Member Lists) 23 
Log File 16, 20, 27, 153 
Logical Screen 13 


Machine Configuration 17 
MASK Line Command 71 
Member Selection List 2, 8, 23 
Menus 2, 8 
Minidisk 8, 9, 146 
Move 
Move Cursor PF Key 11 
Move File or Member (Move/Copy Utility) 109 
MOVE Command 82 
Move "M" Line Command 54 


NULLS Command 86 
Nulls Mode 45 
NUMBER Command 58 
Number Mode 45 


Overlay "0" Line Command 100 
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Page Size 
For Listings 27 
For Scrolling 12 
Passwords 9, 147 
Picture String 35, 37, 67, 790 


Printing 
Automatic Printing of Edited Data 45, 690 
Listing Formats) 150 
PRINT Command 60 
Print Document (SCRIPT/VS) 129 
Print High/Low Intensity 11 
Print Index Listing 103, 152 
Print Listing File 117 
Print Member 104, 151 
Print Member "P"™ Command 24, 104 
Print Mode 45 
Print Option of Move/Copy 109 
Print PF Key 11 
Print Project Entries 113 
Print SPF Library or File 104, 151 
Process 
Batch Processing 134 
Foreground Processing 130 
Language Processors 17, 139, 134 
SCRIPT/VS Document Processing 125 
PROFILE Command 89 
Program Access (PA) Keys 10 
Program Function (PF) Keys 10, 28 
Programming Libraries 6, 145 
Programming Systems 
Project Name 6, 145 
Project Utility 
Display Project Entries 113 
Print Project Entries 113 
Protection (see Passwords) 


Punch 
Punch File with Header 117 
Punch Job (no Header) 117 
Punched Output from Batch Processing 120, 135 


Readcard File 120, 121 
Reader Utility 
Delete (Purge) Reader File 120 
Insert Batch Output in SPF Library 120 
Load Reader File 120, 121 
Readcard File 120, 121 
RECOVERY Command 60 
Recovery Mode 45 


Rename 
Rename SPF Library or File 107 
Rename Member 104 
Rename Member "R™ Command 24, 104 
RENUM Command 59 


Repeat 
Repeat Change PF Key 11, 65 
Repeat Find PF Key 11, 34>, 65 
Repeat "R”™ Line Command 52 

REPLACE Command 84 

RESET Command (Browse) 33 

RESET Command CEdit) 61 

Reset SPF Statistics Utility 
Create/Update SPF Statistics 115 
Delete SPF Statistics 115 

Reshow PA Key 10 

Retrieve Utility 122 

Return PF Key 11 


SAVE Command 62 

Screen Window 12 

SCRIPT/VS Utility 
Display Formatted Document 126 
Draft Document Options 126 
Final Document Options 127 
Print Formatted Document 129 
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Scrolling 12 
Scroll PF Keys 11, 12 
Security Csee Passwords) 
SELECT Command (Member Lists) 24 
Select Member "S"™ Command 24 
Sequence Numbering CEdit) 57 
Shift Line 
Shift Columns Left "CC" Line Command 73 
Shift Columns Right ")" Line Command 73 
Shift Data Left "<" Line Command 73 
Shift Data Right ">" Line Command 73 
Show Excluded Lines 
Show "S" Line Command 78 
Show First. "F™ Line Command 78 
Show Last "L™ Line Command 78 
Specify New SPF Library 106, 145 
SPF Parameters 25 
Split Screen 13 
Split PF Key 11, 13 
Swap PF Key Ill, 13 
Spool Utility 
Disk Dump File 117 
Print Listing File 117 
Punch File with Header 117 
Punch Job (No Header) 117 
Statistics, Library. 15, 115, 149 
STATS Command 59 
Stats Mode ¢5 
Structured Programming 2 
System Requirements 
Machine Configuration 17 
Programming Systems 17 
Terminals 
Submit Batch Job Csee Job) 
SUBMIT Command 62 
Swap PF Key li, 13 


TABS Command 88 

TABS Line Command 87 

Tabs Mode 45 

Tarminal Characteristics 26 
Terminals 8 

Termination of SPF 20 

Text Entry "TE™ Line Command 94 
Taxt Flow "TF" Line Command 98 
Text Preparation Features 93 
Text Split "TS" Line Command 94 
Text String 35, 37, 67, 69 

TSO - Retrieve SPF/TSO Libraries 122 
Tutorial 139 

Type Qualifier 6, 145 


UNNUM Command 59 
Unspecify SPF Library 106 
Update SPF Statistics 115 
User Parameters 
Saving of Parameters 3 
Utilities 
File 106 
Library 103 
Move/Copy 109 
Project 113 
Reader 120 
Reset 115 
Retrieve 122 
SCRIPT/VS 125 
Spool 117 


"X" Line Command (see Excluded Lines) 78 


INDEX 165 
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